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| INTRODUCTION 
| ORGANIZATION | 


PDP-10 software can be generally divided into eight functional groupings with respect to 


common programming activities. These are: 


1. Source Program Preparation; 
Conversational Language Translators; 
Program Loading and Library Facilities; 
Debugging; 

Utilities; 

Calculators; 


Batch Processing; and 


CON O OO FR WO ND 


Monitoring. 


This Guide is arranged according to the above order. 


Source Program Preparation (EDITOR, TECO) 


The DECtape Editor and the Text Editor and Corrector (TECO) programs can be used to create (and later 
correct or modify) text files (e.g., Macro-10 and FORTRAN source language programs) for subsequent 
assembly or compilation. Editor creates and modifies files on DECtape; TECO performs more complex 
editing functions on any standard I/O devices. 


Conversational Language Translators (MACRO, F40) 


The Macro-10 Assembler (MACRO) and the FORTRAN Compiler (F40) translate source programs written 
in the Macro-10 and FORTRAN IV languages, respectively, injobinaty machine language for subsequent 


loading and execution. C . y g, 
: f 2 \ a 8 a’ . ae ae 


Program Loading and Library Facilities (LOADER, LIB40, JOBDAT, FUDGE2) 


Loading is performed by the Linking Loader, which takes specified relocatable binary programs, loads 
them in core, links their references to each other, and searches the appropriate subroutine libraries 
(e.g., LIB40) for required subroutines. A job data area (JOBDAT) is created by the Loader for each 
program; this area is used to store the current status of the job during execution. Library files of binary 
programs can be updated when desired by use of the File Update Generator (FUDGE2). 
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Debugging (DDT, CREF, GLOB) 


Once a program is compiled (or assembled), it can be loaded along with the Dynamic Debugging Tech- 
nique (DDT) program and debugged. DDT allows the user to control program execution and to modify 

his program in any of several modes, including symbolic. For purposes of further program analysis (and 
for documentation), the user can elect to use the Cross Reference Listing (CREF) program, which produces 
a cross-referenced listing of all symbols within his Macro program, and the Global Cross-Reference 
Listing (GLOB) program, which produces one to three helpful listings of all global symbols encountered 
in One or more programs. 


Utilities (PIP, CONVRT, CODE, SRCCOM, BINCOM) 


Digital provides a variety of utility programs for general purpose data handling. Among these programs 
are: the Peripheral Interchange Program (PIP), which transfers data between any standard I/O devices; 
DECtape Format Converter (CONVRT), which converts DECtapes from the old PDP-6 format to the new 
PDP-10 format (or vice versa); Code Translator (CODE), which performs translations between standard 
ASCII codes and code of other manufacturers; Source Compare (SRCCOM), which compares two versions 
of an ASCII file; and Binary Compare (BINCOM), which compares two versions of a binary file. 


Calculators (AID, DESK) 


Two easy-to-use problem solving calculators for scientists and engineers are included as part of the 
PDP-10 software: the Algebraic Interpretive Dialogue (AID), a problem solving calculator which is 
based upon the famous RAND JOSSl algebraic language; and Desk Calculator (DESK), which provides 
immediate access to common arithmetic subroutines. 


Batch Processing (BATCH, STACK) 


The Batch Processor (BATCH) supervises the sequential execution of a series of user jobs with a minimum 

of operator attention, operates as one of the "users" in a time-sharing environment and runs concurrently 
with the Batch-controlled jobs (as well as other jobs on the system), and permits constant communication by 
the operator. Job Stacker (STACK) prepares input stacks for BATCH and processes output stacks from BATCH 


Monitors 


PDP-10 software includes five separate Monitors, ranging from the single-user 10/10 Monitor, designed 
for an 8K paper tape system, to the swapping time-sharing 10/50 Monitor, designed for the 32K (and 
larger) disk systems. In between these are the single-user 10/20 Monitor for an 8K DECtape system, the 
single-user 10/30 Monitor for larger systems, and the time-sharing 10/40 Monitor for 16K (and larger) 
multiprogramming systems. System Builder (BUILD) is used to construct a Monitor specifically designed 
for the user's machine configuration and other requirements. 


l 7 | 
JOSS is the trademark and service mark of the RAND Corporation for its computer program and services 
using that program. 
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SYSTEM OPERATION 


Communication with the Monitor and loading and executing Digital-supplied Common User Service 
Programs (CUSP's), as well as your own programs, is a simple matter once you become familiar with a 


few basic rules. 


To establish communication with the Monitor, yao’ place your Teletype in Monitor mode byentering-the- [AV 
rAdanitor command medey Generally, this is accomplished by typing #C (i.e., by holding down the 

CTRL key while striking "C"). Monitor responds with a period (.) and you can then direct Monitor to 
load and start a program from the System Library (.RUN prog), start a program already loaded in core 


(.START), discontinue your job (.KJOB), and many other operations. 
eG. EDI 70 Ke 
All CUSP's supplied by Digital are device independent. Because of this, you must tell the CUSP, via 


a command string typein, which devices to use. Readiness to receive a command string is signalled by 

the CUSP via an asterisk (*) acaarteds loading. For example, when you have called in the FORTRAN 

IV Compiler and it has responded with an asterisk, you would type in a command string indicating (1) 

the device containing the source program to be compiled, (2) the device on which the Binary output is 

to be placed, and (3) the device on which the compilation listing is to be written: 
*binary-output-device, listing-device<——source-device 


Devices are specified by a 3-character device name pa fourth character, a digit, specifies the particular 


unit in the case of DECtapes and magnetic sacet followed Br q elon 


Card reader CDR: : PTY : 
Line printer LPT: sy Si 
Paper tape reader PTR: PRe 
Paper tape punch PTP: e 
Teletype TTY: Cry. 
DECtape DTAn: , ' 
Magnetic tape MTAn: TT) "ns 
Disk DSK: 


For file-oriented devices (DECtape and disk), a filename is also required following the device name to 
specify either the specific file to be read or the filename to be assigned to the output. A filename can 
consist of a maximum of six characters. A filename can be further specialized by adding a 3-character 
extension name to it, preceded by a period (.). Extension names are generally used to classify a file 
into a particular category and certain standard extensions are used and recognized throughout the system 


” 
(e.g., .REL for relocatable binary er ite for saved core image files, etc.). A sample FORTRAN 


command string might appear as follows. * 


ig aw | PDr¢ 
C74 
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DTAIT:BIN.REL,LPT: @—— DTAO:SOURCE Compile the file called "SOURCE" on 
DECtape 0; write the binary output on 
DECtape 1, calling it "BIN.REL"; print 


the listing on the line printer. 
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COLOR CODE CONVENTIONS 


All computer typeouts are printed in dark blue. 


All operator typeins are Tr, vt 





All scgnailins de is ae inted i in light bh lue, 


a, spon DNA TENTS 


SYMBOLOGY USED IN CONSOLE EXAMPLES 


aC 
ax 


» | 


zé@ Key Designation 


yen 


7 


> GAPE) (not-TAPE) 


BELL 


TAB) (horizontal) 


E 


Zz 


. “TI 
11 


| a | f ? Oo 
= 


(vertical tab) 


Hold down the CTRL (control) key while striking "C." Normally echoes ashe 


ra 


see 


\ 
Hold down the CTRL (control) key while striking the "x" key, where "x” is any 
character. Normally echoes as Ax. 
Some special control symbols and their respective key designations for Models 33 and 


35 Teletypes are given below. 


Shown in This 


Manual as: Method of Entry ! 
OR Hold down CTRL key while striking "R." 
aT Hold down CTRL key while striking "T." 
AG Hold down CTRL key while striking "G." 

—p| or 4] Hold down CTRL key while striking "I." 
at Hold down CTRL key while striking "L." 
aK Hold down CTRL key while striking "K." 
2Q (Initialize paper tape reader input.) Hold 


down CTRL key while striking "Q". 
Os (Terminate paper tape reader input.) Hold 
down CTRL key while striking "S". 
Hold down the SHIFT key while striking "O." 
line feed. 


Strike the RETURN key. Normally echoes back as a carriage return, 
Strike the ALTMODE key (sometimes labelled "ESC" or "PREFIX"). 


Unless o n[o key is present on the keyboard, hold down the SHIFT key while 
striking "K." 
Unless a | "key is present on the keyboard, hold down the SHIFT key while 
striking "M." 


"Method of Entry" is for Models 33 and 35 Teletypes primarily. On the Model 37 Teletype, many of 
the special symbols appear on the keyboard and are easily entered. 
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When appearing alone (as in DDT). Hold down the SHIFT key while striking “N.° 





Hold down the SHIFT key while striking ",". 


> Hold down the SHIFT key while striking ".". 
LINE-FEED Strike the LINE-FEED key. 
; j 
RUBOUT Strike the RUBOUT key. Normally echoes back as a backslash (\), XXX, or a repeat 
of the character erased. 


key is present on the keyboard, hold down the SHIFT key while 


space bar fo space to indicated position. TAB can also be used in most 





vor the Model 37 Teletype, this key is labeled DELETE. 
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| DEMONSTRATION 


The following example is designed to demonstrate the ease of operation and flexibility of a PDP-10 soft- 
ware system. Basically, this particular sequence involves the compilation of a FORTRAN source program, 
the assembly of a Macro-10 subprogram written in conjunction with the FORTRAN program, the loading 
and linking of the two resultant machine language programs, their execution and correction under control 
of the Dynamic Debugging Technique (DDT) program, correction of the original source coding, and a 
final rerun of the corrected programs. Several errors have been purposely introduced in the source coding 
to demonstrate the ease with which testing, debugging, and updating of programs is accomplished. The 
procedure for detaching from the current job, logging in and beginning a second job, and then returning 
to the original job is also illustrated. 


DEMO-I 


FLOW CHART 


USER LOGS IN HIS 
IDENTIFICATION TO 
MONITOR ANDIS 
ASSIGNED A JOB 
NUMBER 


FORTRAN ITZ 
COMPILATION 
(SOURCE STATEMENTS 


ARE INPUT FROM THE 
CARD READER} 


GENERATION OF MACRO 
SOURCE SUBPROGRAM ON 
DECTAPE VIA TEXT 
EDITOR AND CORRECTOR 
(TECO)PROGRAM 





DETACH FROM JOB 1 


MACRO-10 ASSEMBLY OF 
SUBPROGRAM 


USER LOGS IN (4a) 
AS JOB 2 


START CROSS REFERENCE 
LISTING ON LINE 
PRINTER VIA CREF 











ATTACH TO JOB 1 CREF CONTINUES AS (40) . 


USER RETURNS TO JOB 1 


ERRORS DETECTED IN SOURCE CODING CORRECT MACRO SOURCE () 
SUBPROGRAM VIA TECO 


TRANSFER MACRO 
ASSEMBLER BINARY OUTPUT 
FROM DISK TO DECTAPE 
CONTAINING FORTRAN 
OUTPUT 


REASSEMBLE CORRECTED 
SOURCE SUBPROGRAM; 


BINARY OUTPUT WRITTEN 
ON DISK 





LOAD DYNAMIC 
DEBUGGING TECHNIQUE 
(DDT), FORTRAN AND 
MACRO BINARY OUTPUT 
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ee ee ERRONEOUS OUTPUT DEBUG, CORRECT, AND 
EXECUTE (ALL PERFORMED 


UNDER DDT) 


PROGRAM AND MACRO 
SUBPROGRAM (WITHOUT 
DDT} 





LIST DECTAPE DIRECTORY 
(VIA PERIPHERAL 
INTERCHANGE PROGRAM) 


UPDATE MACRO SOURCE 
SUBPROGRAM VIA TECO 
BY CORRECTING ERRORS 
FOUND DURING DDT 
EXECUTION 





®@ [teamereser 
@ [_wenmaresoee 
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CONSOLE OPERATION 





\ 
CG) . LOGIN 


~~ JOB 1 DEC 3.16K J | 


ane 
Rana wr rons 
al a 
Cr 


12,4" sy 
NERY | 
0426 1-27-68 
TCA 


ASSIGN LPTy 
LPT ASSIGNEDWJ 

. ASSIGN CDR¥ 
CDR ASSIGNEDY 

. ASSIGN DTA DTJ 
DTAO ASSIGNE Dy 


.R F40J 


* DT: ARRIVE, LPT: <-— CDR: 


MAIN.ERRORS DETECTED: Og 
TOTAL ERRORS DETECTED: Og 
9K CORE USEDg 


*Foy 


The user begins by identifying himself to the system. 
Monitor assigns the user a job number (JOB 1) anc 
types the version of the Monitor currently in use 
(DEC 3.16K). User then responds by typing his 
project~programmer number (12,4) and his password 
(typed over a mask generated by Monitor). Monitor 
indicates acceptance of number and password by 
responding with the current time and date and $C, 


User assigns the line printer (LPT) and the card reader 
(CDR) to his job (both are nonsharable devices). He 
also requests that an availabie DECtape also be as- 
signed and given the logical name "DT". Monitor 
responds by assigning an available DECtape, DTAQ, 
to the job. At this point, the user mounts his DEC~ 
tape on DECtape unit 0, places his FORTRAN source 
program deck in the card reader, and checks that 
both the card reader and printer are in a ready status. 


OTE: Uf the user is operating from a remote Tele- 
NOTE: If the user is operating fror mote Tel 
as pe, n . fransmit appropriate instruc 
eae type, he can fransmit appropriate instru 
er Ytions to the console operator's Teletype via 
» the Monitor TALK command. 


Directs the Monitor to load and execute the FOR- 


TRAN IV compiler. 


The compiler responds with an asterisk when loaded, 
At this point, the user instructs the compiler to (1) 
read the sues picoram deck from the card reader 
(<+— CDR:); (2) place the binary output on his DEC tape 
and assign if a - lename of "ARRIVE" (DT: ARRIVE); 
and (3) print the compilation listing on the line 


printer (LPT:). 


NOTE: A listing of the FORTRAN source program 
deck is presented in Figure DEMO-1. 
3 


The compiler completes the compilation and Beli the 

number of errors detected and amount of core usedand 

an * to indicate it is ready to do another compilati 
ince the user has no further compilations at this 

time, he returns to the Monitor command level ( #C:, 


KRIissTe Pe ge LATS +. er ae eee ee 
NOTE: The FORTRAN compilation | 
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- DEASSIGN LPT 
- DEASSIGN CDRy 


(3) .R TECOW 





“ITITLE RANDOM NUMBER GENERATING SUBROUTINE g 
SUBTTL CHARLIE PROGRAMMER 27 JAN 1968 


;RANDOM NUMBER GENERATING SUBROUTINEW 
OTOFE 
*I;THE FORTRAN CALLING SEQUENCE IS --y 

CALL RANDOM(ARG),J 
WHERE ARG SPECIFIES THE LOCATION AT WHICH THE RESULTING 
SINGLE PRECISION FLOATING POINT RANDOM NUMBER WILL BE 
STORED. NUMBERS PRODUCED BY THIS ROUTINE ARE "PSEUDO-y 
RANDOM NUMBERS" BUT ARE UNIFORMLY DISTRIBUTED OVER(O, 1]. 


™~e . “me ™~s 


© Od 

*INTERNAL RANDOM 
ACX=5 ; ACCUMULATOR J 
ACY=6 ; SYMBOLIC 


ACZ=ACY+1 DEFINITIONS. 


“ee 
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OO A 


*IRANDOM: 0 ;ENTERED BY JSA 16,RANDOMJ 
CALL — ACX, [ SIXBIT/TIMER ] ;GET TIME IN CLOCK TICKS. 
ANDI = ACX, 3 ;USE TIME TO SELECT 1-4 ITERATIONS. 

© @d | 

*IRLOOP: = MOVE  ACY,RNUMBR ;FETCH PREVIOUS PSEUDO-RANDOM NUMBER. J 
MUL ACY, MAGIC ;MULTIPLICATIVE RANDOM NUMBER GENERATOR. q/ 
MOVEM ACZ,RNUMBR ;SAVE NEXT PSEUDO-RANDOM NUMBER. 
SOJGE ACX,RLOOP jITERATE AGAIN ? 

O@s 

rd LSH —s- ACZ, -#D8 ;CONVERT TO FLOATING POINT FORMAT 
TLO ACZ, 20000 ; IN THE RANGE[O,1] .J | 
FADRI ACZ,0 ; NORMALIZE. 
MOVEM ACZ@(16) ;STORE RESULT, AND - -¥ 
JRA 16,1(16) ;***RETURN. *** Wy 

de 


*1;THE MULTIPLIER USED IN THIS PSEUDO-RANDOM NUMBER GENERATOR IS 5 RAISEDY 
; TO THE 15TH POWER (SEE COMPUTER REVIEWS VOL. 6, NO. 3, REVIEW NUMBERY 
; 7725, AND THE REFERENCED PAPER IN JACM JAN'65 PP83-89) . J 


Gitte BRON 5*5°5"5* 0" 5555 5%" OP OS.» STE MULTIPLIER.) 

Sinan ;THE NEXT RANDOM NUMBER IS ALWAYS HERE J 

;(THE ITERATION STARTS FROM A VALUE OF 1). J 

# ATCH: BLOCK 10 — ;PATCHING SPACE. 

2 END 

© Oe 

*HT The command "HT" followed by two ALTMODE'S 


TITLE RANDOM NUMBER GENERATING ...y 
SUBTTL CHARLIE PROGRAMMER ... ‘pg 
ete. 
PATCH: BLOCK 10 ;PATCHING ....a 
ENDg 
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The user notices that he has made two typing errors: 
() an "I" is missing from "NTERNAL” (the "I" al- 
ready there is the insert command); and (2) a space is 
misssing between "PP" and "83" in his comments line. 


* cs om 
BISNTERNAL @ 7CU@) L219 Search for "NTERNAL"; insert an "I" in front of it, 


OOde and type out the corrected line. For details of this 
INTERNAL RANDOM J a es commana, see the section entitled 

* 

SPP83 @-2CIl OolT@ Ow Search for "PP83", insert a space between the "PP" 


and "83", and bvise out the corrected line. 
; 7725, AND THE REFERENCED PAPER IN JACM JAN '65 PP 83-89. J 


*EWDT :RANDOM.MAC G) PWEF@) G) w Satisified that his source coding fs correct, the user 
directs TECO to write out the contents of the output 
buffer on his DECtape and assign if the filename 
“RAINDOM.MAC", 


Cc J Having finished with TECO, the user returns to the 
Monitor command level, 


4) ‘R MACRO The user directs Monitor to load the Macro~10 As- 
sembler, 
*DSK:BIN, /C <— DT:RANDOM.MACg Macro~10 responds with an * when loaded. The user 


directs Macro-10 to assemble the source program file, 
RANDOM.MAC, located on DTAOQ, The binary out- 
put is to be writfen on disk under the filename "BIN", 
A modified assembly listing is written on the disk . 
(assumed device) with /C switch and assigns it the file- 


name CREF TMP, 


A 000001/040240 000026' CALL ACX,[SIXBIT/TIMER] J 
;GET TIME TN CLOCK TICKS. 


A source language error has been encountered in the 


input. 
THERE IS 1 ERRORY 
PROGRAM BREAK IS 000027, 
5K CORE USEDY 
*4C ,/ User returns to the Monitor command ijevel. 
.) ‘DETACH ) User detaches console from this job without affecting 
| the status of the job. tie is now free to initiate a 
-LOGIN) new job, 
got 2 DEC 3. 16K Mi lonitor responds as before with user logged in as 


AOD Z Ow . 
S 


4 12, 4) 
io a yale 


oa i 


70458(1- 2. yf 
aC p 
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(4B)).R CREF ) 


#C) 


. CCONT 


-ATTACH 1, (12, 4) ) 


(5).r TECO) 


User calls CREF to get the cross~reference assembly 
listing. CREF selects default assumptions of: 


output - dev: LPT: 
input - dev: DSK: 
filename - ext CREF. TMP 


The LPT is available. The user does not assign it so 
that it will be available to other users when his 
listing is completed, 


User interrupts CREF in progress and returns control 
to the Monitor. 


User allows the job to continue running and leave 
the console in Monitor mode. 


Automatically detaches the console from the current 
job and attaches it to job 1 belonging to 12,4 which 
was the previous user job. 


He directs Monitor to load TECO again, 


*ERDT:RANDOM.MAC$YBJS/TIMER @ |/ @ OLT © @) 
CALL  ACX, [SIXBIT/TIMER/];... m, 


*EWDT:RANDOM.MAC @) PWEF®@ © } 


*BC nt 


(6)-k MACRO Q 


* DSK:BIN, LPT:¢— DT:RANDOM.MAC 


THERE ARE NO ERRORS 2 
PROGRAM BREAK IS 000027,) 
5K CORE USED,) 

*FC) 


7) .2e0, 


*DT:RAN .REL @— DSK:BIN.REL 2 


He directs TECO to read its input from filename 
RANDOM.MAC, search for "/TIMER", insert a "/" 
after it, and type out the corrected line. 


He directs TECO towrlte the corrected file over the 
old file on his DECtape by giving it the same filename. 


He then returns to the Monitor command level to cal! 
Macro-10 back in and reassemble. 


The user reloads Macro-10, using the same commands 
as before. The previous contents of the file BIN on 
the disk are overwritten with the binary output pro- 
duced by this assembly. 


NOTE: The assembly listing is shown in Figure 
~~ DEMO-3. 


The user now decides that he would like to transfer 
the binary output file just produced from the disk to 
his DECtape so that it will be together with the other 
orogram files of this job. 


To do this, he directs Monitor to load the Peripheral 
Interchange Program (PIP). 


PIP responds with an * when loaded. The user directs 
PIP to transfer the file BIN.REL from the disk to his 
DECtape and call it RAN.REL. 


DEMO-8 


fC PIP accomplishes the requested transfer and responds 
with another asterisk indicating readiness for a new 
command. 


He returns to the Monitor command level to call 


Linking Loader. 


8 .R LOADER 7, He directs Monitor to bring in Linking Loader ana 


assigns it 7K of core. 


e_ SY Yaevice and the two binary programs, RAN and 
VE, from his DECtape. Linking Loader auto- 

p matically searches for files with an .ext of .REL (both 
h 7 Al the FORTRAN. compiler and Macro Assembler create 
2 


*/D DT:RAN, ARRIVE 2 sysAiv Linking Loader to load DDT (/D) from the 
RI 


a 


ft lp binary output files with this .ext assumed). 
7 5aME 
LOADER } a Loading is completed. Linking Loader returns the user 
EXIT, to the Monitor command level. 
$C) 

? ) START, The user directs Monitor to begin execution of the 
loaded programs at the starting address of the last 
loaded program (i.e., the FORTRAN program, 
“ARRIVE"). 

RANDOM INTER~ARRIVAL TIME GENERATOR... af 
TYPE MEAN WAITING TIME PLEASE: 100.0¢ 


NOW TYPE NUMBER OF SAMPLE TIMES DESIRED:10 g 


The user's program is now in control and prints Instruc- 
tions for entering parameters. 


The user decides to try a mean waiting time of 100 and 
asks for 10 sample random times. 


.77751067E+04y 
. 78527278E+ 04) 
.78476048E+04y/ 
786778 23E+04y/ 
,78103187E+04y 
.77700529E+04q/ 
.77733533E+04y 
.77725470E+04 pf 
.80251919E+04 
. 777879 54E+04 J 


ee ee 
I ilo 
CTO00CCOCOCOC oO 


I| 


I 


TYPE MEAN WAITING TIME PLEASE:?C WJ Since the program has obviously produced incorrect 
results (the output is far from random and conspicu- 
ously in the wrong range), the user returns to the 
Monitor command level. 
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.DDT The user calls DDT to aid him in his debugging. 


ANDOM$:q Although DDT is often used to dynamically obtain 
intermediate results and help the user find his errors, 
RLOOP+5/4yTLO ACZ,20000-TLO ACZ,200000_ it is assumed for the purposes of this example that he 
nas discovered his error by looking at his assembly 
listing. He then uses DDT to correct location 


? 
4 
Q\ RLOOP+5 (he had omitted a zero in his source coding). 
HS Note that DDT permits symbolic typeouts and cor- 
rections. 


MAIN. $: 9 


12P+11$T/ ED:'$ "7ED: / CINE FEED) He also discovers that his FORTRAN program failed to 

12P+12/ ) a '$)/ J space following the second request for input (NOW 
TYPE NUMBER....). Therefore, he also modifies lo- 
cations 12P+11 and 12P+12 in his FORTRAN program. 
For details concerning DDT commands and responses, 
see "DDT." He then directs DDT to begin execution 
of his programs. 


RANDOM INTER-ARRIVAL TIME GENERATOR FOR POISSON PROCESSES #¢ 
TYPE MEAN WAITING TIME PLEASE; 100.09 
NOW TYPE NUMBER OF SAMPLE TIMES DESIRED: /!0Og 


T = 0.13360079E+03 gf 
T = 0.83559460E+01 
T = 0.48267604E+03 § 
T = 0.12974962E+00 g 
T = 0.12997161E+03 9 
T = 0.10218452E+03_¢ 
T = 0.18005033E+03 ¢ 
T = 0.20455130E+02¢8 
T = 0.40742972E+02 4 
T = 0.39184699E+01¢4 
TYPE MEAN WAITING TIME PLEASE: *C | Results appear to be correct this time. The user re- 
turns to the Monitor command level. 

(a1) , SAVE DT:ARRIVE 7 } The user directs Monitor to save the core image of 
his corrected program on his DECtape, calling the 
saved file ARRIVE (the file extension ,SAV is auto- 

| matically appended) He specifies that 7K of core is 
JOB SAVED to be used any time this program is run. After the 
4 C) image file has been written, Monitor automatically 
| returns to the command level. 
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12) -R PIP _ The user now calls PIP and asks for a listing of his 
DECtape directory on his Teletype. In this way, he 

* . . t 
TTY:@—DT:/Lt g verifies that all of the files which should be on the 


426. FREE BLOCKS LEFT J tape are actually there. 
ARRIVE.REL 27-JAN-68¢8 PIP lists the number of free blocks left and the name 
RANDOM.MAC 27-JAN-68¢ - and creation date of each file. 
RAN.REL 27-JAN-68p8 
ARRIVE, SAV 27-JAN-68 6 
13) +h C2 | The user returns to Monitor command mode and 


R TECOY calls TECO. He updates his Macro source pro- 
; gram (RANDOM.MAC) to reflect the correction 
*ERDT:RANDOM.MAC@)YBJS20000@10@0LT@) J made to the binary program via DDT, and has 

| TECO type the corrected line (see "TECO" for 


details of command string). 


TLO ACZ,200000 ; IN THE RANGE(0, 1]. } 


*EWDT:RANDOM. MAC @) PWEF O@)2 The corrected file is written over the old version on 
the DECtape. 


14) RUN DT:ARRIVE g As a final proof that his program now works, he reruns 


the saved version. 
RANDOM INTER-ARRIVAL TIME GENERATOR FOR POISSON PROCESSES g 
TYPE MEAN WAITING TIME PLEASE: 50E+1g 
NOW TYPE NUMBER OF SAMPLE TIMES DESIRED: 4g 


.57171754E+03 g 
.90873993E+03 2 
.49264013E+03 g 
. 22028286E+03 J 


nd 


T=0 
T=0 
| 0 
c= 


TYPE MEAN WAITING TIME PLEASE: # Cy 


15) .KJOB @ | Having finished his work, the user terminates his job 
(KJOB). This releases his job number (and any 
ASSIGNed devices) to the Monitor pool. Monitor 
26.47 § responds by typing the number of seconds of computer 
time used for the entire job and the number of sec~ 
onds since he last asked for this information (via a 
TIME command). The user is now logged off the 
machine and the Teletype is in detached mode. 


6) ATTACH 2 [ 2; 4} 2 Attach to job which had been running CREF. 
7) KJOB) | Kills job and releases devices. 

00.30 

00.30 
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SAMPLE PROGRAM -- CHARLIE PROGRAMMER 27 JAN 1968 


THIS PROGRAM GENERATES RANDOM INTER-ARRIVAL TIMES FOR 
A "POISSON PROCESS" WITH ANY DESIRED MEAN INTER-ARRIVAL 
TIME. (THE INTER-ARRIVAL TIMES FOR POISSON PROCESSES 

ARE THEORETICALLY KNOWN TO HAVE AN EXPONENTIAL 
PROBABILITY DISTRIBUTION.) 


AOADNANDNDANA 


TYPE 9 
FIRST ACCEPT THE MEAN INTER-ARRIVAL TIME FROM THE 
USER (VIA HIS TELETYPE CONSOLE). 
TYPE 10 
ACCEPT 11, TMEAN 
NEXT LET THE USER SIMILARLY SPECIFY THE NUMBER OF 
RANDOM SAMPLES HE WANTS PRODUCED. 
TYPE 12 
ACCEPT 13,N 
ITERATE AS MANY TIMES AS REQUESTED -- 
DO 7 I=1,N 
USE MACROX-CODED SUBROUTINE TO PRODUCE A UNIFORMLY 
DISTRIBUTED RANDOM VARIABLE, R, IN THE RANGE [0,1]. 
CALL RANDOM(R) 
TRANSFORM TO AN EXPONENTIALLY DISTRIBUTED RANDOM VARIABLE. 
T = -TMEAN*ALOG(R) 
TYPE OUT RESULTING INTER-ARRIVAL TIME -- 
TYPE 14,T 
LET THE USER REPEAT ENTIRE PROGRAM WITH NEW VALUES. 
GOTO 6 
FORMAT(' RANDOM INTER-ARRIVAL TIME GENERATOR 
1 FOR POISSON PROCESSES'//) 
FORMAT(! TYPE MEAN WAITING TIME PLEASE: 'S) 
FORMAT(E) 
FORMAT(' NOW TYPE NUMBER OF SAMPLE TIMES DESIRED: '$) 
FORMAT(I) 
FORMAT(! T = ',£15.8) 
END | 


aOOAD 


ene) 





Figure DEMO-1 =FORTRAN Source Program Deck 
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ARRIVE 1/27/67 


6P 


2M 


7P 


9P 


17:18 


MOVEI 
OUT. 
FUN: 


MOVE] 
FIN. 
MOVE]I 


DATA. 
FIN. 


MOVEI 
OUT. 
FIN. 


MOVEI 
IN. 
DATA. 
FIN. 


MOVEI 
MOVEM 
BLOCK 0 


JSA 
ARG 


SSA 
ARG 
FMPR 
MOVNM 


MOVEI 
OUT. 
DATA. 
FIN. 
CAMGE 
ADJA 


JRST 


JRST 

ASCII 
ASCII] 
ASCII 


01,9P 
01 ,777777 
00,0 


01, 10P 
01, 777777 
00,0 


01,11P 
01,777774 
02, TMEAN 
00,0 


01,12P 
01 ,777777 
00,0 


01,13P 
01, 777774 
00,N 
00,0 


? 


16,RANDOM 
02,R 


16,ALOG 
02,R 
00, TMEAN 
00,T 


01,14P 

01 ,777777 
02,T 

00,0 

15,N 
15,3M 


6P 


4M 
("RA 
NDOM 
INTER 


Figure DEMO-2. 


BOD MQNANNANAN 


ene 


a a 


SAMPLE CHARLIE PROGRAMMER 27 JAN 1968 
THIS PROGRAM GENERATES RANDOM INTER-ARRIVAL TIMES FOR 
A "POISSON PROCESS" WITH ANY DESIRED MEAN INTER-ARRIVAL 
TIME. (THE INTER-ARRIVAL TIMES FOR POISSON PROCESSES 

ARE THEORETICALLY KNOWN TO HAVE AN EXPONENTIAL 
PROBABILITY DISTRIBUTION.) 


TYPE 9 


FIRST ACCEPT THE MEAN INTER~ARRIVAL TIME FROM THE 
USER (VIA HIS TELETYPE CONSOLE). 
TYPE 10 


ACCEPT 11,TMEAN 


NEXT LET THE USER SIMILARLY SPECIFY THE NUMBER OF 
RANDOM SAMPLES HE WANTS PRODUCED. 


EYRE 12 


ACCEPT 13,N 


ITERATE AS MANY TIMES AS REQUESTED -- 
DO 7 I=1,N 


USE MACROX-CODED SUBROUTINE TO PRODUCE A UNIFORMLY 
DISTRIBUTED RANDOM VARIABLE, R, IN THE RANGE [0,1]. 
CALL RANDOM(R) 


TRANSFORM TO AN EXPONENTIALLY DISTRIBUTED RANDOM VAIRABLE. 
T = -TMEAN* ALOG(R) 


TYPE OUT RESULTING INTER-ARRIVAL TIME -- 
VYPE. 14,7 


LET THE USER REPEAT ENTIRE PROGRAM WITH NEW VALUES. 
GO TO 6 | 


FORMAT (' RANDOM INTER-ARRIVAL TIME GENERATOR 
] FOR POISSON PROCESS'//) 


FORTRAN Compilation Listing 
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AM 


10P 


5M 
11P 
6M 


12P 


7M 
13P 
8M 


-14P 


9M 


MAIN. %o 


_SUBPROGRAMS 


FORSE. 
RANDOM 
ALOG 
FLOUT. 
FLIRT. 
INTO. 
INTI. 
EXIT 


SCALARS 
TMEAN 
N 


I 
R 
T 


ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 


ASCII 
BLOCK 0 


JRST 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
BLOCK 0 


JRST 
ASCII 
BLOCK 0 


JRST 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
ASCII 
ASCH 
ASCII 
ASCII 
ASCII 
BLOCK 0 


JRST 
ASCII 
BLOCK 0 


JRST 
ASCII 
ASCII 
ASCII 
BLOCK 0 


JSA 
RESET: 
SRST 


3M 


6M 


7M 


8M 


9M 


16, EXIT 
00,0 
1M 


115 
116 
117 
120 
12] 


10 FORMAT(' TYPE MEAN WAITING TIME PLEASE: '‘$) 
Cony: 
PE ME 
AN WA 
ITING 
TIME 
PLEA 
'$) 
1] FORMAT(E) 
(E) 
12 FORMAT(' NOW TYPE NUMBER OF SAMPLE TIMES DESIRED:'S) 
("NO 
W TYP 
E NUM 


13. FORMAT(I) 


14 FORMAT (' T = ', E15.8) 


END 


Figure DEMO-2 (Cont.) FORTRAN Compilation Listing 
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RANDOM NUMBER GENERATING SUBROUTINE 


MACROX  V003 17:46 27-JAN-68 PAGE ] 
TITLE RANDOM NUMBER GENERATING SUBROUTINE 


SUBTTL CHARLIE PROGRAMMER 27 JAN 1968 
;RANDOM NUMBER GENERATING SUBROUTINE 


;THE FORTRAN CALLING SEQUENCE IS -- 

: CALL RANDOM(ARG) 

;WHERE ARG SPECIFIES THE LOCATION AT WHICH THE RESULTING 
;SINGLE-PRECISION FLOATING POINT RANDOM NUMBER WILL BE 
;STORED. NUMBERS PRODUCED BY THIS ROUTINE ARE "PSEUDO- 
RANDOM NUMBERS" BUT ARE UNIFORMLY DISTRIBUTED OVER [0,1]. 


INTERNAL RANDOM 
000005 ACX=5 ;ACCUMULATOR 
000006 ACY=6 ; SYMBOLIC 
000007 ACZ=ACY+] ; DEFINITIONS. 
000000 000000 000000 RANDOM: 0 ;ENTERED BY JSA 16,RANDOM 
000001 040240 000026" CALL ACX, [SIXBIT/TIMER/] ;GET TIME IN CLOCK TICKS. 
000002 405240 000003 ANDI ACX,3 ;USE TIME TO SELECT 1-4 ITERATIONS. 
000003 200300  000015' RLOOP: MOVE ACY , RNUMBR ;FETCH PREVIOUS PSUEDO-RANDOM NUMBER. 
000004 224300 000014! MUL ACY ,MAGIC ;MULTIPLICATIVE RANDOM NUMBER GENERATOR. 
000005 202340 000015! MOVEM ACZ,RNUMBR ;SAVE NEXT PSUEDO-RANDOM NUMBER. 
000006 365240 + ~—- 00003" SOJGE  ACX,RLOOP jITERATE AGAIN ? 
000007 242340 + ~=—- 777770 LSH ACZ,-1D8 ;CONVERT TO FLOATING POINT FORMAT. 
000010 661340 020000 TLO ACZ, 20000 ; IN THE RANGE [0,1]. 
000011 145340 000000 FADRI ACZ,0 ;NORMALIZE. 
000012 202376 000000 MOVEM  ACZ,@(16) STORE RESULT, AND -- 
000013. 267716 + ~—- 000001 JRA 16, 1(16) ; *** RETURN. *** 
;THE MULTIPLIER USED IN THIS PSUEDO-RANDOM NUMBER GENERATOR IS 5 RAISED 
; TO THE 15TH POWER (SEE COMPUTER REVIEWS VOL. 6, NO. 3, REVIEW NUMBER 
; 7725, AND THE REFERENCED PAPER IN JACM JAN'65 PP 83-89), 
000014 343277, 244615. = MAGIC: 5*5*5*5*5*5*5*5*5*5*5*5*5*5*5 .-THE MULTIPLIER. 
000015 000000 000001 RNUMBR: 1 ;THE NEXT RANDOM NUMBER IS ALWAYS HERE 
j(THE ITERATION STARTS FROM A VALUE OF 1). 
000016 PATCH: BLOCK 10 ;PATCHING SPACE. 
END | 
000026 645155 456200 
THERE ARE NO ERRORS 
PROGRAM BREAK IS 000027 
RANDOM NUMBER GENERATING SUBROUTINE MACROX 003 17:46 = 27-JAN-68 PAGE 2 


SYMBOL TABLE 


ACX 000005 

ACY 000006 

ACZ 000007 

MAGIC 000014" 

PATCH 000016" 
RANDOM 000000' INT 
RLOOP 000003' 
RNUMBR 000015' 


5K CORE USED 





Figure DEMO-3 


Macro-10 Assembly Listing 
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| DECTAPE EDITOR (EDITOR) 


To create, add to, or delete from sequentially 


FUNCTION 


numbered source files recorded in lines of ASCII 


characters on a DECtape : 


@ Provides a simple method of creating or 


modifying Macro or FORTRAN IV source 


programs 


ENVIRONMENT 









Equipment One DECtape unit for the reel containing the file(s) to be 
Required modified. 






Minimum Core 





Editor edits the source file; i.e., the input and output files are the same. Fresh source files have editing 
space in each physical DECtape block. If the user has more edits for a block than will fit in it, an extra 


block in the DECtape is used and appropriately linked to the preceding and following logical blocks of 
the file. | 


EDITOR-1 


INITIALIZATION | 


»R EDITOR} Loads the DECtape Editor program. 


Editor is ready to receive a command. 


COMMANDS 


INITIALIZE A FILE FOR PROCESSING 


SnfA Select DECtape n and zero the directory. 
Sn, filename .extt#A @LIMODE Select DECtape n, zero the directory, and create 


a file called filename.ext. 


Sn, filename . ext) | Select DECtape n and locate filename.ext for 
processing. 


Sn, filename. ext(ALTMODE 7 Select DECtape n and add a new file called 


filename.ext. 


NOTE: All the above commands place Editor in the command mode; i.e., the next typein is assumed 
to be one of the commands given below. 


INSERT A LINE 


Innnnn 2 Insert the following typed line at line number nnnnn 
of the currently open file; nnnnn can be specified 

nnnnn aaaa as a line sequence number or as a point (.). A 
point refers to the last line typed. If the line num- 


nnnxx (ALTMODE m| ber already exists in the file, the line is replaced. 


* 





INSERT MULTIPLE LINES 


Innnnn, increment, Insert the following typed lines, beginning at line 
number nnnnn of the currently open file; nnnnn can 
nnnnn aaaa.. adap | be specified as a line sequence number or as a point 
| (.). Each time a line is entered, nnnnn is increased 
nnnxx bbbb.. .bbb 2 by the specified increment (assumed to be 00010 if 


omitted) and the result becomes the line number for 


nnnxx (ALTMODE 2 the next insertion. Type ALTMODE after last line 


insertion. 
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DELETE A LINE 


Dnn nnn) 


* 


DELETE A SERIES OF LINES 





Dmmmmm, nnnnn) 


*k 


PRINT A LINE 
Pnnnnny 


nnnnn aaa.. aca) 


* 


PRINT A SERIES OF LINES 





Pmmmmm, nnnnn a 


mmmmm aad... .aaa ) 


nnnnn bbb.. -bbb) 


* 


CLOSE THE CURRENT FILE 


ED 


Delete line number mnnnn from the currently open 


we 
i 


FEE 


é 
Hy 


z 
Se Gg PRA bo Pe 4 
number or as 


Prt PR Qe} 


Bg as 


2a 


te Be eek oe are wt 
Pile, pie e 


Py, g B 6 z rad 
3 g i Boe rR arg, Bote Bity a ee ee L ° 7% 2 So gt gmt, . 4 me 
wWOIGTEe PINGS UTA PArGugna ONAN Trom ne cure 
rent) 7 rae FEAT & gx 
3 EY fbs 2 ¥ Sa pe wii SERRE g 
etek § tres ney £ than -; a] % oe ow 

RS ‘ Ms. : 2 ¥ 
rary eho EXPEL EL, S APA Or Tne CUPrenriy ODN 1:€, 
BEE PS eg pny ay bs ge sryaritiar oye me iG a CeCe mce mt mber 
PEL EELPER DT Ae €Zbd BSED 2 RAhe is GE TRA Lae BA pare PEQuUENS = PTO? 
ae: oA ss a. 7% EY i ‘ 
uf He fd EARP EYE } ® 

x ¢ 


L 


§oses Tne 


“ 


ope 


oes ereeran fear acer es Re 7 L : nF, 
ss mmrnmen Through nonnn of the currently 


ca 


wR Ae ‘ Ra ~ ine Z P . peg Me gtey i 
currently ooen file. Another file can be 
° F 


& 


§ ix = pe the da Large, iffe is & rs, ee pe % 
nea on tne same or a different Ur Ctoape via an 
i 


n command, or a return can be made to Monitor 


to terminate Editor, 
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EXAMPLES 


~R EDITOR, 
*S1, VECTOR(ALTIMODE 
*120, 20) 


00020 DEFINE VMAG (A,B), 
00040 < MOVE 0,AQ 
00060 FMP OW 

00080 MOVE 1,Ati, 
00100 FMP 1,1Q. 
00120 FAD iQ 

00140 MOVE 1,A+2,2 
00160 FMP 1,1, 
00180 FAD 1, 

00200 JSR FSQRTY 
00220 MOVEM By 
00240 @LTMODE)) 


-*120) 
00020 DEFINE VMAG (A,B,C) J 


*ILRY) 


*190) 
00090 MOVE 1,CQ 


*ILS*) 


*D180,) 


Select DECtape 1 and create a new file on it called 


VECTOR. 


Begin inserting at line sequence number 20 and in- 
crement this number by 20 each time a line is in- 
serted. Switch to text mode. 


Editor responds with first line sequence number. 
Operator types line of coding to be inserted, fol- 
lowed by a carriage return. | 


Typing ALTMODE terminates insertions and returns 
Editor to command mode. 


Change line number 00020. 


*ILR* indicates that the indexing increment has re- 
sulted in the next line number being equal fo that 
of an already existing line (00040). Note that the 
indexing increment remains as 20 until explicitly 
changed. 


Insert a line between lines 00080 and 00100. 


*ILS* indicates that the indexing increment has re- 
sulted in an existing line (00100) being skipped, 
since the next line addressed would be OO110. 


Delete line OO180. 
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*P20, 220 Q 


00020 


DEFINE VMAG(A,B,C)) 


00040 < MOVE 0,AQ 


00060 


00080. 


00090 
00100 
00120 
00140 
00160 
00200 
00220 


*x EQ 
4c 2 


FMP Op 
MOVE 1,AtiQ 
MOVE 1,CQ 
FMP 1,19 
FAD 1a 
MOVE 1,At22 
FMP 1,12 
JSR FSQRTJ 
MOVEM Ba 


.KJOBA 


Print lines 00020 through 00220. 


Close the currently open file. 
Return to the Monitor. 


Kill the job, deassign the DECtape, and release 
core, | 


EDITOR=-5 


DIAGNOSTIC MESSAGES | 


Table EDITOR-1 = Editor Diagnostic Messages 


Device data error due to a write error or WRITE LOCK switch. Editor must be 
restarted. 


DECtape directory is full. 
A file name assigned to a new file already exists on the DECtape. | 


next existing line to be either replaced (R) or skipped (S). This is a warning 


SLLR* 
Sg 
message only and does not necessarily indicate an error. 


Not a current file. 


A command requiring an active file has been given but no file is currently 
open. 


A print (P) or delete (D) command refers to a nonexistent line. 
The DECtape specified in an Sn command is assigned to another job. 






















THlegal command. 










The line sequence increment specified for the insert function will cause the 
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| TEXT EDITOR AND CORRECTOR (TECO)! 


To edit files recorded in ASCII characters on any 


FUNCTION 


standard device. 


e Performs simple editing functions as well as 
highly sophisticated search, match, and 
substitute operations 


¢ Operates upon arbitrary length character 
strings under control of commands which are 
themselves character strings (and contains the 
mechanisms necessary to exploit this recursive~ 
ness) 


ENVIRONMENT 


Werte a 
winimm cae [ak 


Additional Core 










Takes advantage of any additional core available. Each 1K 
additional core augments the basic 6,200+- character buffer 
by 5K additional characters .~ 


Equipment One input device and one output device. 
Required a 
1 


PDP-10 TECO was developed at Project MAC, Massachusetts Institute of Technology. The work of the 


following people is acknowledged: Daniel L. Murphy, Stewart Nelson, Jack Meneveye niceaig Green- 
blatt. 


LOAN 

2TECO automatically requests more core to expand its buffer onde : Bion wal shHowite-sitvertions : 

. An insert by way of the "I" command or "X" (Q Register) will overflow the eescat memory 
—~——jJboundaries. | 

2. The command acceptance routine needs more core. 

3. The total number of characters in the Data Buffer falls below 5000, and an input command 
from a peripheral device (other than the user console) is executed. Thus, TECO maintains a Data 
Buffer of at least 5000 characters. 

If TECO is successful at obtaining more core, the following message will be typed: MA, VU, 

*10000<1J$>$$ 9 

STORAGE CAPAC ITY EXGEEDED 


als Nees 5K GORE IN wees we Tuk COFFE Jf ann W 1s 


, es a 
If TECO is unsuccessful at obtaining the core request, the following message is typed: Cog 
STORAGE CAPACITY EXCEEDED | Sek: 


~TTK NEEDED, NOT AVAILABLE 
? 


* 
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INITIALIZATION 


~R TECOX Loads rhe Text Editor and Corrector program. 


= TECO is ready to accept a command. 


BASIC COMMANDS 


NOTES: When typing command strings to TECO, the following points should be noted. 


- One ALTMODE is used to terminate the text within a command string, 


where applicable; two successive ALTMODE's terminate the entire com- 
mand string sequence and generate a RETURN, LINE-FEED. ALTMODE's 
type back as $'s. 


RUBOUT - The RUBOUT key can be used to erase the preceding typed-in character(s) 
of a command string. Each character erased is echoed back on the Tele- 
type (e.g., ABD (RUBOUT) DC...). Successive RUBOUT's can be used 
to erase more than one character. | 
N.B. To erase a carriage return (which generates RETURN, LINE-FEED), 


two RUBOUT's are required, one RUBOUT to erase the LINE- 
FEED and one to erase the RETURN. 


Two successive #G's ( (BELL) 's) can be used to wipe out the entire 
command string currently being typed. 


TECO commands in the form 4x (where "x" is any character) can be entered by either holding 
down the CTRL key while striking the "x" key or typing up-arrow (shift N) followed by the "x" 
character, These alternatives are not true where ?x is a character within a text string (such 
as in a Search argument); in this case, the CTRL key must be used. 


A carriage return, line feed, (J) is ignored in a TECO command string as long as it does 
not appear within a particular command, such as Insert. Examples of this are given on the 
following pages. | 
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SOFTWARE MANUAL UPDATE OCTOBER-DECEMBER, 1968 


System User's Guide (DEC-10-NGCB-D) ~ ee 


_ First supplement to this document is available. In addition je igi cei minor errors aed reflecting 
software changes on the pages included in the phsae distribution, this supplement contains hew sec~ 

tions on AID, Macro-10 Instruction Summary, the S » Sine -User (10/20, 10/30) System Builder and Mon- 
ier rs, and Assembly Instructions for CUSP’s. | \ 


oe 





This supplement i is available to all re holders of the System User's Guide and may be dines fron 


your local sales office.or fi from thé Program Library. \ 
a \ 
Changes not included 7 this on \ 
< i 
2 oe 
Page - (lines 4 and 5) Changes... oh yee place...... Monitor command mode. " to 


.., place your Teletype in Ménitor command mode. 


Sacee 


(line 17) Change "in the case of DECtapes magnetic tapes)" to "in the ide 






POE SAN YAM PALS EECA A GS iow eae ETE 


_ of DECtapes, magnetic tapes, and Teletypes) " 


(2 lines from bottom) Change ".DMP!to.".SAVE 






Page TECO-I (lines 7 and 8 from bottom) Change: "STORAGE CAPACITY EXCEEDS 1K 
NEEDED, 5K COREIN JOB" to~— Lae 


Soe 2: - 
ORE] 


cre 


where n is new core size of job 


(SELECT THE INPUT DEVICE" ~ line 2) Flag "dev:" with a superscript 1. 

dau 

("SELECT THE INPUT DEVICE" - bottom of box) Insert: 

EBdev: filename .ext [proj , prog] Edit Backup - Selects an input 
and file to be edited (the input device, which will 
also be the output device for the edited file, must 
be the disc"): EB is intended to be used to keep a 
backup of a file during : debugging session, without 


the user having to invent a new name for each version 


of the file. 





Teeo-F% 


For example, the command string sequence 


EBPROG1.MAC 


editing 
i+ CEINODE) GLIMODE) 
results in 


(1) Reading from file PROGI.MAC on disk 

(2) Creating a new output file, which is initially 
given a temporary name of TECOnn. TMP, where 
nn is the user's job number in octal; incorporating 
job number in the filename solves the problem of 
identifying temporary files belonging to multiple 
100 , 100 users 

(3) Performing a number of RENAMEs following 
the EF command so that the input file becomes 
PROGI.BAK, any previous PROG1.BAK file is 
deleted, and the new output file becomes 


PROGI.MAC. 


An ER command can be given following an EB com- 
mand and before the EF command, but an interven- 
ing EW command is illegal and results in the error 
message ?22 (see Table TECO-2B). Even though an 
ER command may be given, the name of the final 


output file is still taken from the EB command. 


("SELECT THE OUTPUT DEVICE" = line 5) Flag "dev:" with a superscript 1. 
, 


dev: 
("SELECT THE OUTPUT DEVICE" - bottom of box) Insert: 
EX EXit - The EX command finishes the current edit 


operation by (1) writing out all remaining pages of a 
file, (2) performing an EF (End of File) command, 
and (3) then exiting to the Monitor. (Thus, EX is 
equivalent to the command string 


1000000PEF (BELL)) 


(Bottom of page) Add the footnote: 


I bd e e e 
pag PENS “We MOP SPEC Mee DOK Ne GSUNEE 26 OR ERAN ECE MBER, 1060 
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SELECT THE INPUT DEVICE 
ERdev:filename.ext [proj, prog] 


(DECtape} 

(paper tape reader) 
(disk) 

(magnetic tape) 
{card reader) 
(Teletype) 


filename. ext (DSK: or DTAn: only) © 
[ proj, prog] (DSK: only) 


Specified only if file is located in 
other than user's area. 





SELECT THE OUTPUT DEVICE 


EWdev:filename. ext [ proj, prog] Selects the output device and file (if specified), 
EZdev:filename.ext [proj, prog] Selects the output device and file (if specified}, 


and rewinds the tape (if magnetic tape) or zeros 
the directory (if DECtape). 


dev: DTAn: (DECtape) 
DSK: (disk) 


MTAn: (magnetic tape) 


PTP: (paper tape punch) 
LPT: Gine printer) 
TTYn: (Teletype) 

filename. ext (DSK: or DTAn: only) 


[ proj, prog| (DSK: only) 


Specified only if file is located in 
other than user's area. 


EF Terminate output on the current output file and close 
the file without selecting a new output file. 


MAGNETIC TAPE POSITIONING 


EM Rewind the currently selected input magnetic tape. 


Depending upon the value of n, perform one of the 
following operations on the currently selected input 
magnetic tape. 
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¥ 


MAGNETIC TAPE POSITIONING (Cont) 


NOTE 1: Throughout TECO, all numbers in command strings are interpreted as decimal. 


Operation 


| Rewind tape to load point. 
3 Write end of file. 

6 — Skip one record. 

7 Backspace one record. 

8 Skip to logical end of tape. 
9 Rewind and unload tape. 


1 Erase 3 inches of tape. 
14 Advance tape one file. |. 
15 Backspace tape one file. 







(a) Line Feed 
(b} (orm Feed 


or a point 128 characters from the end of the buffer is reached. 
NOTES: 
1. The FORM Ehatecier, if read, does not enter the buffer. 
Any data previously residing in the buffer is destroyed. 


The pointer is positioned immediately before the first character in the buffer. 


me OG BR 





Read from the current input device and append 


information already 
residing in the buffer. Terminate reading on the same conditions as in Y. 


NOTES: 
1. No previous data is destroyed. 


2. The pointer is not moved, 
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OUTPUT COMMANDS 


PW Output the entire buffer to the selected output device, with a FORM character appended 


as the last character. Do not alter the contents of the buffer or move the pointer. 
_? & 
Equivalent to a PW command followed by a Y command (i.e., output the current contents 


of the buffer followed by a FORM character, and then read in more data from the input 


device). P= 1P 


If n is specified, repeat this operation n times. If nis omitted, it is assumed to be equal 
oman a 


Output the m+] through the nth character from the buffer to the current output file. Do 
not append a FORM character at the end. Do not alter the contents of the buffer or 
move the pointer. 





EDITING COMMANDS 


Move the Pointer 


nJ Move pointer to right of the nth buffer character and give the pointer symbol (.) the 
value of n. If n is omitted, set pointer in front of the first buffer character (same as 
OJ). | 

nC Set the pointer to the right of the nth character beyond the pointer's present position 


(equal fo .tnJ). Ifn is omitted, 7 is assumed. 


nR Set the pointer to the left of the nth character prior to the pointer's present position 
(equal to .=nJ). Ifn is omitted, 7 is assumed. 


nb +n = Move the pointer to the right, stopping after it has passed over n LINE=FEED 
characters. 


~n ~ Move the pointer to the left, stopping after it has passed over n+] LINE-FEED 
characters, then move to the right of the last LINE=FEED character passed over. 
If n is omitted, assume IL. | 





Delete Text 
nD Delete n characters. 
+n - Delete them just to the right of the pointer. 
-n ~ Delete them just to the left of the pointer. 
If n is omitted, | is assumed. 
nk +n = Move the pointer to the right, stopping after it has passed over n LINE=-FEED 
characters. Delete all characters the pointer passes over. 
=n ~ Move the pointer to the left, stopping after it has passed over n+] LINE=FEED 
characters, then move it to the right of the last LINE-FEED character passed over. 
Delete all characters between this point and the pointer's previous position. 
If n is omitted, 1 is assumed. 
m,nKk Delete the m+] through the nth characters of the buffer. Set the pointer where the 


deletion occurred, 
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EDITING COMMANDS (Cont) 


Insert Text 


—7 


Insert the text following the "I” up to, but not including, the ALTMODE character, begin~ 
ning at the current pointer position. Move the pointer to the right of the inserted material. 


nl Insert at the pointer location a character whose ASCII code is n (n must be a decimal 
value}. Move the pointer to the right of the inserted character. 


n\ Insert at the current pointer location the ASCII text representation of the decimal value 
of the expression n. Move the pointer to the right of the inserted text. | 


—ol text... 


Insert at the current pointer location a TAB ( tf ) character and the following text up 
to but not including the ALTMODE character. Move the pointer to the right of the 
inserted text. 





@I1/text/ Insert at the current pointer location the text which follows. The text is delimited by 
a character, /, which can be any character not appearing in the text. 


Type Text 


NOTE: T commands do not move the pointer. 


nT Type out the string of characters beginning at the current pointer position and terminating 
after the nth LINE-FEED character is encountered. 


+n Pr lines to the right of the current pointer position. 

~n Wn lines to the left of the current pointer position. 
as 4S itt % mig v i un i of be al 

If n is omitted, the value is assumed to p 


m,nt Type out the m+] through the nth characters of the buffer. 
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Open an Input File 


a) 


Open an Output F 


) 
) 
¢) 
Po 
a) 
b) 


Read a Page 
a) Y 
b) A 
Output Data 


c) 


b) 
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Delete Text 
a) JI9C3D 


or 


b) 19,22K 


Insert Text 


a) J2LITAG: MOVE 1,AMT) 


b) 6A \ 





d) @I*#ERDSK:PROG # 


Typing Text 


a) 3T 


b) 25,100T 
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Move the pointer to the right of the 19th 
character in the buffer and then delete 
fhe next three characters to the right 
(characters 20,21, and 22), 


Delete the | an (20th) tlar POM h the Zend 
g 
characters of phe puffer ry 


Move the pointer to a pasition following 
the second line of the buffer: insert the 
text "TAG: MOVE 1,AMT® between 
the second and third lines of the buffer. 


by 


my oon + , # i i A CP y A od 
inser the ¢ gits 6&9" in ASC at thd} 


ee 


current Shin position (same as 16% 
ae OL). 


eTyped Witte Sher tPF Or »P 


insert a tab tf lew by the text "ERROR 
IN JOB" af the current pointer position. 


eee 4 8 . 
Insert the text "ERDSK:PROG CLIMOD®D 
at the current pointer position. 








a 


BR abn f ae ee ree eee 
ype oul the 25+) (26th) through the 


é 
ferset i oe OES Care ts eee Pe 
O0th character of the buffer. : {\ 


_ EXAMPLES (BASIC) 


.R TECOQ 
*ERDTAI :SCFILE MAC (ALTMODE) ) 


*EWDTA2:EDFILE. MAC (ALTMODB) y 
*Y0, 20T ) 


qaqgqdq...... .aaaaa 


*3LT (ALTMODD) ) 


bbbbb.......bbbbb) 


puis ISA sp slid INSERT, 
GLIMODD) 


*1OPT (QLIMODE) ) 


CCCOCS suc -CCCCC ) 


‘k @IMODD GAIMODD ) 


-*200PPWEF GLIMODD 


6 @LIMODD ) 
EXIT J 

eC 

.KJOBJ 
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alied SCFILE. MAC on 


Read a buffer of information from the 
input file and type the first 20 char- 
acters of the buffer 

Move the pointer to the right, stopping 
when three LINE-FEED i ters have 
been encou: nieeeds i e the text of the 
fourth line in the puffer, 

Insert the text “THIS 1S A SAMPLE 
INSERT? tween the third and fourt! 
line ae five ‘buffer and position the 
pointer after the inserted material. 
Write out the current buffer to the 


data and position the 
fhe beginning of the offer 


nares i 
type out the first line of the bulfe 
oe g 2 # 
Weiere Tris Pin eS 


a a oe ae a) ? ety $ cay be a ' % E> Ll. one gue SR RE $ a 
roe pte ers AE OE 1& be te CSE EE La 





¢ 
3 
now) first line in 


Repeats the write and read cycle 200 
+; 


= 
oD 
oft 

% 
me 


N ey 2 g 
x 2 Bee “o : > * 4 Y Ag 
ic writes out the last page oe-~- 


: Po rica luigi g- 9s are i 
fore terminating the output file. 


em ; x} ; *% 3 . ie g 3 
Return control to the Monitor ofter al! 
output requests have been completed. 


Kill the job, deassign all devices, re- 
lease core. 


ADVANCED COMMANDS 


SEARCH COMMANDS 


Summary 


S text (ALTMODE) - Searches for text in current buffer only. 
N text (ALTMODE) = Searches for text through successive buffers by repeatedly writing out current 


buffer and reading in next buffer (P command). 


«— text (ALTMODE) - Searches for text through successive buffers by repeatedly reading in new 


bufferful of information (Y command). 
All searches begin at the current location of the pointer. 
Modifiers: | 
Each search command can be preceded by the modifier characters, : and/or @ 


causes the search command to have a numeric value at completion; 

0 if the search has failed (the requested text was not found) or 

-] if the search was successful (the requested text was found). | 
@ indicates that the text to be matched is delimited by some character (same as in the @1 

commana). | 


Numeric Arguments: 


A numeric argument can appear following the modifiers (if any) but preceding the command. If 
the numeric argument is n, TECO searches for the nth occurrence of the text. Ifn is not used, 
the value of n is assumed to be "1." 


Pointer Positioning: 
If search is successful, the pointer is positioned to the right of the matched text. — 
If the search fails, the pointer is positioned at the beginning of the buffer. 


Use of Special Characters Within Text: 


_*S - Match any separator character (any character not a letter, number, period, dollar 
sign, or percent symbol). : 
&x ~ Match any (arbitrary) character. Used when the contents of some position within 
the text is unimportant. 
4 Nx - Match any character except x. 
4Q ~ Takes the next character literally, even if it is one of these four special characters. 
3 For example, S#Q4X  (ALTMODE) - Find the character? X. — 


NOTE: See note on page TECO-2. 
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Table TECO-1 Search Commands Summary 


Command Action at End Action at End Typeout ? 
of Buffer of File | Success | | Fail if Failure 


Failure 
Failure | | at 


Performs a P command Failure 
and resumes search 


Performs a P command Failure 
and resumes search 


Performs a Y command Failure 
(read only) and resumes 
search 


Performs a Y command Failure 
(read only) and resumes 
search. 


Q-REGISTER COMMANDS 


Q registers are provided for storing quantities, command strings, or buffer contents for later use. Thirty- 
six Q registers, labeled 0 through 9 and A through Z, are available. 


nUi Places the numeric value n-in Q-register i. 
Qi | Represents the current value in Q-register i. 
%i | Adds | to the value in Q-register i and represents the new value. 


m,nXxXi - Copies characters m+] through the nth character of the buffer into Q=register i. 
Does not alter buffer contents or pointer. 


nXi | Copies the buffer characters between the current pointer position and the nth LINE- 
FEED character in Q-register i. 


Inserts the text contained in Q-register i into the buffer beginning at the current 
pointer location. Set the pointer to the right of the insertion. 


Pushes the contents of Q-register i onto the Q-register pushdown list. 


Pops the top entry of the Q-register pushdown list into Q=register i. The Q-register 
pushdown list is cleared each time two successive ALTMODE's are typed. 
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Mi 
<> 


N; 


/ tag: 


n"G 
n'L 
n"N 
n"E 
n'C 





0 through 9 
B 
Z 


Qi 
nA 


6H 


MACRO, ITERATION, AND CONDITIONAL COMMANDS 


Perform the text in Q-register i as a series of commands. 


Bros 





NOTE: The "and ' symbols are matched in the same way as the ( and ) symbols. 


NUMERIC VALUES AND ARGUMENTS IN COMMAND STRINGS 


Many command string formats permit arguments with numeric values. The following characters may ap- 
pear in a command string to develop these values in any instance where a numeric value is permissable. 




























[teration brackets. When> is encountered, command interpretation is sent back 
fO-S4 | 





Perform the commands within the iteration brackets n times. 


If not in an iteration, an error results. If most recent search failed, send command 
interpretation to just beyond the matching >on the right; otherwise, no effect. 


If not in an iteration, an error results. If the value of n is O or greater, send com= 
mand interpretation just past the matching > to the right; otherwise, no effect. 


Tag definition. Tag is the name of the location in which it appears in a command | 
string. 

Go to the named tag, which must appear in the current macro or command string. 
as ce ke een interpretation to the next matching '; tf n >0, = eh 

If n > 0, send “command interpretation to the next matching’; if n <0, noeffect. 
Ifn=0,s Command interpretation to the next matching'; if n #0, nqeffect. 
Ifn # 0, ser command interpretation to the next matching'; if n = 0, no sH€ct. 


[f n is not one of the symbol constituents (a letter, number, period, dollar sign, or 
percent symbol), sea command interpretation to the next matching '; otherwise, 


Spe hp 






Represent their corresponding numeric values. 
Equivalent to 0. 
Equivalent to the number of characters in the buffer. 


Equivalent to the number of characters to the left of the current pointer position (or 
in other words, equal to the current pointer position). 


Equivalent to most recent numeric vaiue placed in Q-register i. 


Equivalent to ASCII value of character to right of pointer; n is used to differentiate 
this argyment from an Append command (A) and has no other significance. 


Equivalent to value of elapsed time in 60ths of a second since midnight. 


Equivalent to the value of the console data switches, 
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NUMERIC VALUES AND ARGUMENTS IN COMMAND STRINGS (Cont) 


E Has the value of the form feed switch. If, during the last Y or A command 
execution, data transmission was terminated by a form feed character, PE has 
a value of -1, otherwise, the value is 0, 


ms (On Models 33 and 35, hold down both the CTRL and SHIFT keys and type "N".) 
Equivalent to the ASCII value of the next character in the command string; this 
character is not interpreted as a command, 


4T Stops command execution until user types a character on the Teletype; #7 then be- 
comes equivalent to the ASCII value of the character typed, 


\ Equivalent to the value represented by the digits (or minus sign) immediately follow- 
ing the current pointer position. The value is terminated by the first nonnumeric 
character encountered. The pointer is positioned immediately following the value. 





mtn Add | : 
Take one or two ar poms: A space is equal tot. 
m-n Subtra | 
* 
m*n ulti 
ply > Take one or two arguments. 
m/n Ms e (truncates) | 
mé&n Logical AND; bike AND of binary representations m and n. 
min Logical IOR; bitwise inclusive OR of binary representations m and n. 
t ate i s 8 
() Operators +, ~, *, /, 7, and & are normally performed left to right. This sequence 


can be overruled by use of parentheses. NOTE: TECO does not assume that mul- 
tiplication and division are always performed before addition and subtraction. 
Thus, to obtain the equivaient of a + (b * c), one must use the parentheses; other- 
wise, fa +b) * c is assumed. 


n= Causes the value of n to be typed out. 


H Abbreviation for B, Z. (O through the last location of the buffer; in other words, 
the whole buffer). 


NOTES: If a command takes two numeric arguments, a comma is used to separate them. 


TECO TERMINATION COMMANDS 


aC Returns control to the Monitor without waiting for any I/O operations to finish. 


4G (BELL) Returns control to the Monitor after completing all current output requests. 
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Search 


- J3SMOVE IM 


Search for a Special Character 


a) S@NA 
b) S4s 


Q-Registers, Macros, Iterations, and Conditionals 


a) JOUN<S (CINE-FEED 
ALTMODE) ; %N>QN= 


b) J<SJUMPA (QALTMODE); -4DIRST (ALTMODE) > 
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Within the current buffer, search for the 
third occurrence (35S) of the text "MOVE", 
position the pointer immediately after it, 
and insert an "M" at that point. 


Search for any character except A within 
the current buffer. 


Search for any separator character within 
the current buffer. 


Count the number of LINE-FEED char- 


acters in the buffer as follows: 


1. Position the pointer at the be- 
ginning of the buffer (J), 


2. Place 0 in Q-register N (OUN), 


3. Perform a search for a LINE- 
FEED character ( S LINE-FEED 
ALTMODE); if one is found, 
add 1 to Q-register N (;%N). 
Go back (<>) and repeat this 
cycle until the end of the buf- 
fer is reached and the test fails 
(;); at this point type out the 
contents of Q-register N (QN=). 


Replace all instances of the text" JUMPA" 
with "JRST" in the current buffer. 


1. Position the pointer at the be- 
ginning of the buffer (J). 


2. Search for JUMPA; when found, 
backspace the pointer four posi- 
tions and delete the four char- 
acters passed over (;-4D). 


3. Replace these four characters 


with the characters "RST" (IRST). 


4, Repeat this routine (<>) until 
the test fails (end of the buffer 
has been reached) and exit (;) 
1.7% 


To Place a Command in a Q-Register for Later Execution 


@l# JOUN<S (LINE-FEED |. Insert the text " JOUN<S (LINE-FEED) 


ALTMODE) ) Ee YDE) ;%N>QN=" into the 
iSON>QN=* HXP CNG scat testshte it) 





NO 


Copy the contents of the buffer into. 
Q-register P (HXP). 


To Execute the Command: 


1. Read in a page of a file to search. 


(ERDTA3:FN.EX CALTMODE) Y) 


ERDTA3:FN.EX CALTMODE) YMP 2. Execute the command stored in Q- 
register P (MP). 


To Read in Text to be Inserted in Several Places in a File and to Store it in a Q-Register 


ERPTR: YHXP 2g 1. Assume that the text to be inserted 
is on paper tape. Open an input 
file on the paper tape reader 
(ERPTR:); read the text into the 
buffer (Y); copy the contents of the 
buffer into Q-register P (HXP). 


ERDTA4:TXTEDT (ALTMODE ) 2. Open the input file to be edited 
EWDSK:TXTEDU (@LTMODE) 2 peer ca MGC ONG Na Ie 
YNCALC: (ALTMODE) GP, 3. Read a page from the input file and 


initiate a search for the text "CALC:". 
When found, insert the text stored in 
Q-register P at that point (GP). 


NTOT: (ALTMODE) GP 4, Search for the text "TOT:" and, when 
found, insert the text stored in Q- 
register P after it. 
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EXAMPLES (ADVANCED) 


.R TECO ) 


*ERMTAIL: CALTMODE) EMI4EM CALTMODE ALTMODE) ) 


*EZDTAI:REVFIL CALTIMODE)(ALIMODE ) 


*YNTAXRT OLT,) 
1X1 @LTMODE) (LTMODE) ) 


agaa...1AXRT aaaa...... aaaaa ) 


* INTXRTE OLT 
G1 (LTMODE) @LTMODE) ) 


bbb...TXRTE bbb...... bbbbb y 


*NTXTEND: (@LTMODE) ) 


J<SA (ALTMODE) ;1A-47"G1A-58"L-DIB CALTMODE oS) 


PWEF (ALTMODE) @LTMODE) ) 


‘Tc GLIMODE ) 
EXIT 


PC) 


-KJOB ) 
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Select MTAI for input; rewind the tape 
(EM) and advance the tape one file 
(14EM). 


Select DTAI for output; zero the direc- 
tory; open a file and call it REVFIL. 


Read in the first page from the input file; 
search for the text "TAXRT"; if not 
found, write the buffer out, read in the 
next page, search again, etc.; continue 
this cycle until either TAXRT ts found 

or end of file is reached. If TAXRT is 
found, position the pointer at the be- 
ginning of the line containing it, type 
the line, and place the line in Q- 
register |. 


Search the buffer for the text "TXRTE"; 
if not found, write out the buffer, read 
the next page, search again; continue 
this cycle until either TXRTE is found or 
end of file is reached. If TXRTE is _ 
found, position the pointer at the be- 
ginning of the line containing it, type 
the line, and insert the contents of Q- 
register | immediately before that line. 


Read pages from the input file and write 
them on the output file until end of file 
(marked by the text "TXTEND:") is 
found. At that point, move the pointer 
to the beginning of the buffer (J), and 
search for all A's in the buffer (SA); if 
the character following the "A" is a 
digit, 0 through 9 (ASCII codes 4819 
through 5719), change the "A" to a "B" 
(IB); continue searching and modifying 
until end of buffer is reached; write out 
last page and write end of file on output 
device. 


Return control to the Monitor after all 
output requests have been completed. 


Kill the job, deassign all devices, re- 
lease core. 


| Pages SRCCOM-1 through SRCCOM-4 - Replace with attached pages. 


Page BINCOM-3 


= BINCOM-4 


Page DESK-6 


Page BATCH-3, 
BATCH-4 


STACK Section 





age BUILD-4 


Page MONITOR-6 


Page MONITOR-7 


Page CUSP-4 
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(line 5, command column) Change "file 1-word... -XOR" to "loc file-1-word 


file 2-word XOR" 


(Table BC-1) Replace this table with Table BINCOM-1 on the following page. 
(last line) Change to: 
“octal loc. filel-word file2-word XOR of both words" 


(line 3, command column) Change "0.54402" to "-0.54402" 


(line 6, command column) Change "0.839" to "-0.839" 


‘Note that commands can be abbreviated to just the two or three letters necessary 


to make them unique (e.g., IN, SK, EN, EF, etc.) 


A library writeup, "PDP-10 Job Stacker (STACK)", is now available. You may 
want to place this writeup in this section of your manual until the next System 


User's Guide Supplement is available. 


(third line from bottom) Change 
"Standard = 2 (200 bpi, odd)" to 
"Standard = 2 (556 bpi, odd)" 


(line 4, Format Column) Change "proj ,prog" to "[proj ,prog] " 


(line 14, Diagnostic Messages Column) Change "An error was detected while" 


to "An error was detected while reading or" 


(line 13 - Command Column) Change "...3616)2 " to "...3616J " 
(line 14 - Command Column) The "@ " should be blue. 
(line 16 - Command Column) The "¢ "should be blue. 


OCTOBER-DECEMBER, 1968 


DIAGNOSTIC MESSAGES 


Table TECO-2A TECO Diagnostic Messages 


n is a decimal number associated with one of the list of error messages given 


in Table TECO-2B, 


TECO ignores the remainder of the command string and returns to the idle 
state. At this point, the user can type back ?, causing TECO to type out the 
command string terminated by the bad command. 











Table TECO-2B Error List for ?n Messages 


Meaning 








TECO attempted to read commands beyond the terminating ALTMODE ALTMODE. 
This error is probably due to an unterminated @I or @S command, or to an un- 
satisfied O command. | 


Same as I. 


An attempt was made to supply more than two arguments to a command, either by 
the use of two commas or by "H,". 


Too many right parentheses. 
= command with no argument. 
U command with no argument. 


Q, U, X, or G command specifies an illegal Q-register (i.e. , other than A 
through Z or 0 through 9). 


In an X command, the second argument is not greater than the first. 
In a G command, the Q-register does not contain text. 


In a G command, the data in the Q-register is not in correct form (this is an in- 
ternal error). 


In an Ec command (e.g., ER, EW, EF, etc.), ¢ is illegal. 
File not found on LOOKUP. 


Blank filename specified for directory device. 





Project-programmer number specified does not have UFD. 
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Table TECO-2B (Cont) Error List for ?n Messages 


Protection failure on disk. 

File cannot be accessed because it is currently being written. 
LOOKUP or ENTER returned error type 6 (not defined). 

LOOKUP or ENTER returned error type 7 (no device). 

Directory full on ENTER. 

Requested I/O device not available. 

Not assigned. 

EW command between an EB command and its EF. 

EM command given, but no input file open. 

nEM command, where n is not in the range 1 to 16. 

Internal error: EF after EB, but no input file is open. 

Illegal character in filename. 

Illegal character in project-programmer number. 

Attempt to read an input page when no file has been opened for input. 
I/O error on input device. 

Attempt to output a page when no file has been opened for output. 
Two arguments were supplied for an L command. 

Attempt to move pointer beyond page. 

A 2-argument command has its second argument less than the first argument. 
Attempt to search for too long a character string. 

Search command did not find the required string. 

In an M command, the Q-register does not contain text. 


In an M command, the data in the Q-register is not in correct form (this is an 
internal error). 


Unmatched right angle bracket. 


OCTOBER-DECEMBER, 1968 
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Table TECO-2B (Cont) Error List for ?n Messages 


a 


; encountered when not in iteration. 
" command with no numeric argument, or "x where x is not G, L, E, N, or C. 


This is the number typed out at the end of the ? command's dump of the command 
string in error. Refer to the number of the previous error. 


A character has been encountered as an undefined command. 


A tD command, when DDT has not been loaded with TECO. 


Not enough core available from the Monitor. 


A RENAME attempted with either a blank name or one already in use. Presum- 
ably due to a fault in the EB command. 
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Debugging Aids 


As an aid in debugging macros and iterations, TECO can be set in the trace mode by typing ? 
as any character other than the first in a command string. When in trace mode, TECO types out each 
command as it is interpreted, interspersed with requested output. Typing a second ? in the same manner 
takes TECO out of trace mode; the ? can be typed each time it is desired to change the current mode. 


The user can also type comments on his Teletype sheet as he executes TECO by typing: 
T Atext TA 


This causes all text entered to be printed on the Teletype (with the exception of terminating T A 


character). 


NOTE 


Since the terminator f A is not a command, it must be typed 
by holding the CTRL key down while typing "A"; it cannot 
be entered as "up arrow, A." 


If DDT (Dynamic Debugging Technique program) has been loaded along with TECO by Linking 


Loader, control can be transferred to DDT by using the command 


TD 
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| MACRO—10 ASSEMBLER (MACRO) 
FUNCTION To assemble source programs coded in the Macro-10 


programming language and produce machine langu- 
age programs which are compatible with the Linking 
Loader and the Dynamic Debugging Technique pro- 


gram. 


@ Sophisticated 2-pass assembly 
@ Device independent 
@ Complete macro instruction facilities 


@ Symbolic linkage to other independently- 
_ generated programs 


@ Unlimited indexed/indirect addressing and ex- 
panded address arithmetic 


@ Ten data-generating pseudo-operations and 
eleven conditional assembly pseudo-operations 


@ Object coding produced in either relocatable 
or absolute address format 


@ Accepts input from any input device 


ENVIRONMENT | 
5 


Additional Automatically requests additional core assignments 
Core from the time-sharing monitor as needed. 


Equipment 
Required 
















One input device (source program input). Two 
output devices (machine language program output 
and listing output). If the listing output is to be 
used as input to the Cross Reference (CREF) program, 
it must be written on either DECtape, magnetic 
tape, or disk. | 
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INITIALIZATION 


-R MACROYW 


COMMANDS 


General Command Format 


Loads the Macro~!10 Assembler into core. 


The assembler is ready to receive a command. 


objprog-dev:filename.ext, list-dev:filename.ext «— source-dev:filename.ext, 


objprog-dev: 


liste-dev: 


source=-dev: 


be cued source=n ) 


The device on which the object program is to be 
written, 


MTAn: = (magnetic tape) 
DTAn: (DEC tape) 

PTP: (paper tape punch) 
DSK: (disk) 


The device on which the assembly listing is to be 
written, 


MTAn: = (magnetic tape) Must be one of 
DTAn: (DEC tape) | these if input 
DSK: tami to CREF. 

LPT: line printer) 


TTY: si etype) th WW) . 
PTR ice(s) WANA Ss 


to assembly is to be read. 


ore iostai input 


MTAn: = (magnetic tape) 


CDR: (card reader) 
DTAn: (DEC tape) 

DSK: (disk) 

PTR: (paper tape reader) 


TTY: (Teletype) — 


If more than one file is to be assembled from a mag- 
netic tape, card reader, or paper tape reader, dev: 
is followed by a comma for each file beyond the 
first. 


Input via the Teletype is terminated by typing 
CTRL Z (@Z) to enter pass 1; the entries must be re- 
typed at the beginning of pass 2. 
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filename.ext (DSK: and DTAn: only) 


The filename and Fees extension of the objec 
program file, the listing file, and.the source File( i 


—— The object program and listing devices are separated 


from ne source device by the left arrow syereete—— qK 


Disk File Command Format 
DSK:filename .ext [ proj, prog] 


[ proj, prog] Projeci-programmer nur sales 


Notes: 


hits igiie> Hm. yee da Be Healey gos pel AE ag, Oe a. boy oe ae es ere eee An, ee e Las ¢ 
output is not desired (as In the case where a program is being scanned for source lang= 





1 ; : 
Standard protection (055) designates that the owner is permitted to read or write, or change the pro- 
tection of, the file while others are permitted only to read the file. 
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EXAMPLES 


.R MACRO, 
*DTA3:OBJPRG, LPT: <— CDR:) 


END OF PASS 1) 


THERE ARE 2 ERRORS» 
PROGRAM BREAK IS 002537) 
5K CORE USEDJ 


*BC 
.K JOB) 


* 


.R MACRO 
*MTA3:, MTA2:<—MTAI:, my 


THERE ARE NO ERRORS, 
PROGRAM BREAK IS 003552p¢ 
&K CORE USED, 


*, LPT:<—DTA1:FILE1 , FILE2, FILES) 
THERE ARE NO ERRORS® 
PROGRAM BREAK IS 001027) 
6K CORE USED 


* , —DSK:FILET MAC [14,12] ) 


THERE ARE NO ERRORS 
PROGRAM BREAK IS 000544) 
5K CORE USED | 


*& C) 
.KJOB, 

.R MACRO 
*MTAI:, TTY: — TTY) 
JMP 
AOS 


JFCLQ ” 
END, 


me source 


met 
= 
song 
tb 
ee 


R: 
G: 
Z, 
END OF PASS IQ 
JMP RY 


ces 
beat ag 
a 
sioty 
6) 
od 
Were 
if 


We 
7 
"eta brant sail 





rc “i j 


z 
i> gs 
sot hye an Te 


 TLYPTAa? ‘tno 
1 DTAS anc 


: 4 
eee repre & Pe 
PaaS TRUST De 


q 2 7 aoe j ag 
manually refed for 


‘ Ste is os z ov Sot ems gy eet ye Ngee aos sewer git \ : oy ey, et arg as 
Number of source errors. Size of object program, 


ite ¢ £ & & 
Z tony § 44 yk Be > gat vy Sie, Egy ay 
Ore USea OV ASsernoier, 





A coos min! os ten naoywk +h eo Le RENE ERO feu 
ASSEMpIe TNe next tnree source Tlie 


AYRE AOE KOO hee AS RAL Low 2 tee Ss ab 
MIGSenTr DOSITIOMN OT NLL AAD, WREITO 7 nS OO § ke 
* e a 4 
; age “S ; 
Ee 


r 
i x yes rated 4 i Fabs i ef < gt; Oy er < es “ Me 
on MTAS; write fhe listing on MTAZ to 


ee | Re eee ee eee er cy omit cs i 
Assemble the source ss named FILE! , VAL EL CG 
aso Re ee eg YT arr 2 ee 3 

FILES from DTAI; produce no object coding; write 


si = eee ; j z cm en ® é 
the listing on the tine printer. 


Siete 2 sa awa myer 4 
source program called FILE).MAC, loca- 
mas 

$d Fs, é ODF SOL? ao i 4 1G PNA Seg Re 

i i * 
ng gm ye & 2 “4 
; ; listing 
eo 


ar Pi “ 2 2 
: iy Fee py ee saa Ge gig Sarna Ange pay pal gilt ge 
sic ¢ oeyices, and release core, 


A os Po be eR ye te et Sy oe 

Assemble a source file from the Teletype; write the 
i * Fag 5s T A rae 3 Ls NE ge 

object code program on MTA! and print the assem~ 

4 & ey ‘. i " 5s ae H ; 

rly listing on the Teletype. 


Terminate input. 
Reenter Teletype input. 


Reenter the first statement, 
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~MAIN MACROX.H9 10:14 
O 000000 000000 O00001' 
R: AOS Gp 


000001 350000 000002' 


G: JFCLY 


000002 255000 000000 


END, 


THERE IS 1 ERROR, © 


PROGRAM BREAK IS 000003) 


MAIN MACROX.H9 10:14 
SYMBOL TABLE) 

G 000002 ',9 

R 0000011) 


5K CORE USED 
*ACJ 
: KJOB) 


20-DEC-67 PAGE Ip Page heading. 
JMP RA First assembled, 
Reenter second. 
R: AOS G) Second assembled. 
Reenter third, 
G: JFCL) Third assembled. 
Reenter fourth, 


E ND) Fourth assembled. 


20-DEC-67 PAGE 2, Typeout of symbol table. 


Return to the Monitor. 


Kill the job, deassign all devices and release core. 
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SWITCHES 


Switches are used to specify such options as: 
1. Magnetic tape control, 

2. Macro call expansion, 

3. Listing suppression, 

4, Pushdown list expansion, and 

5.  Cross-reference file output. 


All switches are preceded by a slash (/) (or enclosed in parentheses) and usually occur prior to the left 
arrow, 


Table MACRO-1 = Macro-10 Switch Options 


0 A Nl a = 


Advance magnetic tape reel by one file. 

Backspace magnetic tape reel by one file. 

Produce listing file in a format acceptable as input to CREF. 

List macro expansions (same function as LALL pseudo~op). 

Reinstate listing (used after list suppression by XLIST pseudo-op or S switch). 
Suppress error printouts on the Teletype. 


Increase the size of the pushdown list. This switch may appear as many times 
as desired (pushdown list is initially set to a size of 80, 4 locations; each 
/P increases its size by 80) 


uppress Q (questionable) error indications on the listing; Q messages in- 
dictte assumptions made during pass |. 


Suppress listing (same function as XLIST pseudo~op). 


Skip to the logical end of the magnetic tape. 
Rewind the magnetic tape. 
Suppress all macro expansions (same function as XALL psuedo-op). 


Zero the DECtape directory. 


Must immediately follow the device or file to which it refers. 


Unless the file is named, CREF.TMP is assigned as the filename; if no 
extension is given, .TMP is assigned; if no list-dev: is specified, DSK: 
is assumed. | 
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EXAMPLES 


.R MACROg 
* MTA1:,DTA3:/C #— PTR:) 


END OF PASS 1, 


THERE ARE 3 ERRORS) 
PROGRAM BREAK IS 000401) 
5K CORE USED, 


* DTA2:A SSEMB.ONE/Z, LPT: — MTA4:/W,) 


THERE ARE NO ERRORS, 
PROGRAM BREAK IS 005231) 
6K CORE USED) 


* MTAI:/W,LPT:<— MTA3 :/W , (AA) , (BB), 
THERE IS 1 ERRORQ 


PROGRAM BREAK IS 000655, 
5K CORE USED, 


*OC,) 
.KJOBAQ 


Assemble one source file from the paper tape reader; 
write the object code on MTAIT; write the assembly 
listing on DTAS in cross-reference format and call 


the file CREF.TMP. 


The paper tape must be refed by the operator for 
pass 2, 


End-of-assembly messages. 


Rewind MTA4 and assemble the first two source files 
on it; write the object code on DTA2, after zeroing 
the directory, and call the file ASSEMB.ONE; write 


the assembly listing on the line printer. 


Rewind MTAI and MTA3 and assemble files 1, 4, and 
3 (in that order) from MTAS. Print the assembly list- 
ing on the line printer. Write the object code on 


MTA]. 


Return to the Monitor. 


Kill the job, deassign all devices, and release core. 
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DIAGNOSTIC MESSAGES 


Table MACRO-2 = Macro-10 Diagnostic Messages 


eines 


2? CANNOT ENTER FILE DTA or DSK directory is full; file cannot be entered. 


filename.ext 


2? CANNOT FIND filename.ext | The file cannot be found on the device specified. 
? COMMAND ERROR The last command string is in error. 


? DATA ERROR ON DEVICE dev: Output error has occurred on the device. 


@ELL) END OF PASS1 This message is issued prior to pass 2 whenever the 


input source file is on a medium which must be man- 


ually re-entered by the operator (PTR:, CDR:, TTY: ). 
When this message appears, the operator must refeed 
the tape or cards or retype the entries. 


? IMPROPER INPUT DATA The input data is not in the proper format. 
PINPUT ERROR ON DEVICE dev: 


? INSUFFICIENT CORE An insufficient amount of core is available for 
assembly. 
nk CORE USED Amount of core used for this assembly. 


LOAD THE NEXT FILE 





Manual loading is required for the next card or 





paper tape file. 


° NO END STATEMENT The END statement is missing at the end of the 
ENCOUNTERED ON INPUT FILE source program file. 

?dev: NOT AVAILABLE | The device is assigned to another user or does not exist. 

? PDP OVERFLOW, TRY/P A pushdown list overflow has occurred. 


PROGRAM BREAK IS nnnnn The highest relative location occupied by the object 
program produced. 


? THERE ARE n ERRORS Number of source language errors found. 
THERE ARE NO ERRORS 
? THERE IS 1 ERROR 
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INSTRUCTION OPERATIONS 


The extensive PDP-10 instruction repertoire is structured around a design that implements all possible 
variations at the object code level. Thus, instructions which add or subtract may store the results 
either in an accumulator or in memory or both. Boolean operations admit all 16 combinations of two 
variables, while arithmetic compare and modify codes permit branching on the eight possible results. 
This logically complete instruction set contributes significantly toward reduction in program length and 


running time. 


Instruction List 


Instructions are organized around basic operations. A mode is appended to the instruction mnemonic to 


specify the result destination, test conditions, and other options on the basic operation. 


Arithmetic and Logical 


Fixed point arithmetic is single precision and negative numbers are in 2s complement form. Double 
precision is facilitated by using the CRYO and CRY1 flags which record the hardware~generated carries 


from bits O and | of the arithmetic unit. Overflow is recorded in the AROV flag. 


ADD (270) add 

SUB (274) subtract 

MUL (224) multiply 

IMUL (220) integer multiply 
DIV (234) divide 

IDIV (230) integer divide 


combine (AC) and (E) 
results —» (AC) 


Immediate 


combine (AC) and E 


results —» (AC) 


Memory | 
combine (AC) and (E) 


results —» (E) 


Both 
combine (AC) and (E) 
results —-» (AC) and (E) 
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Instruction Codes 


ADD 
ADDI 
ADDM 
ADDB 
SUB 
SUBI 
SUBM 
SUBB 


IMUL 
|MULI 
IMULM 
IMULB. 
MUL 
MULI 
MULM 


MULB 


IDIV 
IDIVI 


IDIVM 


IDIVB 


DIV 


(270) 
(271) 
(272) 
(273) 
(274) 
(275) 
(276) 
(277) 


(220) 
(221) 
(222) 
(223) 
(224) 
(225) 
(226) 


(227) 


(230) 


(231) 


(232) 


(233) 


(234) 


(AC) + (E) - (AC) 
(AC) + E -» (AC) 

(AC) + (E) — (E) 

(AC) + (E) - (AC), (E) 
(AC) - (E) - (AC) 
(AC) - E —» (AC) 

(AC) - (E) —» (E) 

(AC) - (E) ~» (AC), (E) 


High order part of the product 
is lost for all IMUL instructions. 
The overflow flag is set if the 
high order part is non-zero. 


(AC) x (E) - (AC) 

(AC) x E — (AC) 

(AC) x {E) -» (E) 

(AC) x (E) - (AC), (EF) 

(AC) x (E) + (AC), (AC + 1) 
(AC) x E -» (AC), (AC + 1) 
(AC) x (E) -» (E) 

low order part discarded 
(AC) x (E) —» (AC), (E) 

low order part —» (AC + 1) 


overflow occurs during IDIV 
only if the divisor is zero 


(AC) + (E) — (AC) 
remainder —» (AC + 1) 
(AC) + E —» (AC) 
remainder —» (AC + 1) 


(AC) = (E) - (E) 


"remainder ts discarded 
(AC) + (E) —» (AC), (E) 


~ remainder —» (AC + 1) 


[ (AC) + 27-99 (AC + 1)| 
+ (E) — (AC) 


remainder —» (AC + 1) 
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DIVI (235) 
DIVM (236) 
DIVB (237) 


35 


(AC) +2 “x (AC + i)| 


* E —» (AC) 

remainder (AC + 1] 

[(ac) + 2° (ac +1)] 
+ (E) — (E) 

remainder is discarded 


[Ac +27 (ac +1) | 
+(E) —» (AC), (E) 


remainder — (AC + 1) 


Floating Point Arithmetic - Exponents are excess 200, except that a 0 fraction will result in a 0 


exponent. Results are normalized except for UFA. Arithmetic flag indications are: 


AROV FOV FXU 
1 0 
1 | 0 


| | | 


Add, Subtract, Multiply 


FAD (140) 
FSB (150) 
FMP (160) 


DCK 


QO floating exponent overflow 

| floating divide check 

0 floating exponent underflow 
floating add 


floating subtract 


floating multiply 


result —» (AC) 


Long | 
double precision result —» (AC), (AC + 1) 
Sign and exponent of (AC + 1) are positive, 


27, , less than (AC) exponent, and not 
normalized 


Memory 


result —» (E) 


Both 


result — (AC), (E) 
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Instruction Codes 


Divide 


FDV 


(170) 


Instruction Codes 


FAD 
FADL 
FADM 
FADB 
FSB 
FSBL 
FSBM 
F SBB 
FMP 
FMPL 
FMPM 
FMPB 


(140) (AC) + (E) - (AC) 

(141) (AC) + (E) —» (AC), (AC +1) 
(142) (AC) + (E) > (E) 

(143) (AC) + (E) (AC), (E) 
(150) (AC) - (E) -» (AC) 

(151) (AC) ~ (E) + (AC), (AC +1) 
(152) (AG) =e(E) oe te) 

(153) (AC) - (E) -» (AC), (E) 
(160) (AC) x (E) — (AC) 

(161) (AC) x (E) -» (AC), (AC + 1) 
(162) (AC) x (E) —» (E) 

(163) (AC) x (E)-* (AC), (E) 


floating divide 





quotient —» (AC) 


Long 

quotient — (AC) 

remainder — (AC + 1) 

sign of the remainder is the sign of the dividend 
Exponent of the remainder is 27 9 less than that 
of the dividend. 


Memory 
quotient —» (E) 


Both 


quotient —» (AC), (E) 


FDV 
FDVL 


FDVM 
FDVB 


(170) (AC) + (E) —» (AC) 

(171) (AC) + (E) - (AC) 
remainder ~—» (AC + 1) 

(172) (AC) + (E) — (E) 

(173) (AC) + (E) -» (AC), (E) 
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Rounded 


FADR (144) floating add and round 
FSBR (154) floating subtract and round 
FMPR (1 64) floating multiply and round 
FDVR (174) floating divide and round 


rounded result —» (AC) 


Immediate 
the second operand is E, left justified with zeros 


in the right half of the word rounded result —» (AC) 


Memory 
rounded result —» (E) 


Both 
rounded result —» (AC), (E) 





Instruction Codes 


FADR (144) (AC) + (E) -» (AC) 
FADRI (145) (AC) + E - (AC) 
FADRM (146) (AC) + (E) => (6) 
FADRB (147) (AC) + (E) -» (AC), (E) 
FSBR (154) (AC) ~ (E) - (AC) 
FSBRI (155) (AC) - E — (AC) 
FSBRM (156) (AC)-= (BE) =>, {E) 

F SBRB (157) (AC) - (E) + (AC), (E) 
FMPR (164) (AC) x (E) ~ (AC) 
FMPRI (165) (AC) x E — (AC) 
FMPRM (166) (AC) x (E) — (E) 
FMPRB (167) (AC) x (E) — (AC), (E) 
FDVR (174) (AC) + (E) — (AC) 
FDVRI (175) (AC) + E — (AC) 
FDVRM (176) (AC) + (E) — (E) 
FDVRB (177) (AC) + (E) — (AC), (E) 
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Miscellaneous Floating Point 


UFA (130) -unnormalized floating add. Same as FAD except 
: that the result is not normalized. 


(AC) + (E) > (AC + 1) 
DFN (131) double precision floating negate 
- |(AC), €)] + (Ac), €) 
the exponents are not changed 


FSC (132) floating scale 
2. (AC) -» (AC) 


Boolean 


All 16 boolean operations on two variables are provided. The contents of the accumulator and the 


operand are combined on a bit for bit basis. The table below gives the results for all operations. 


Operand Bit 
Accumulator Bit 


0 
0 
0 
0 
0 
0 
0 
0 


wed mee tel 
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combine (AC) and (E) 
results —-» (AC) 


Immediate 
combine (AC) and E 


zeros are assumed in the left half of the operand 


result —» (AC) 


combine (AC) and (E) 
results —» (E) 

combine (AC) and (E) 
results — (AC) and (E) 





Instruction Codes 


SETZ (400) 0 -» (AC) 

SETZI (401) 0 ~ (AC) 

SETZM (402) 0 —» (E) 

SETZB (403) 0 — (AC), (E) 
SETM (414) (E) —» (AC) 
SETMI (415) E —» (AC) 
SETMM (416) (E) >» (E) 

SETMB (417) (E)—» (AC), (E) 
SETA (424) (AC) - (AC) 
SETAI . (425) (AC) -» (AC). 
SETAM (426) (AC) — (E) 
SETAB (427) (AC) -» (AC), (E) 
SETCA (450) (AC)! —» (AC) 
SETCAI (451) (AC)' > (AC) 
SETCAM (452) (AC)! —» (E) 
SETCAB (453) (AC)'-> (AC), (E) 
SETCM (460) (E)' ~» (AC) 
SETCMI (461) E' —» (AC) 
SETCMM — (462) (E)' —» (E) 
SETCMB (463) (E)'~—» (AC), (E) 
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SETO 
SETOI 
SETOM 
SETOB 


AND 
ANDI 
ANDM 
ANDB 


ANDCA 
ANDCAI 
ANDCAM 
ANDCAB 


ANDCM 
ANDCMI 
ANDCMM 
ANDCMB 


ANDCB 
ANDCBI 
ANDCBM 
ANDCBB 


(474) 
(475) 
(476) 
(477) 


(404) 
(405) 
(406) 
(407) 


(410) 
(411) 
(41 2) 
(413) 


(420) 
(421) 
(422) 
(423) 


(440) 
(441) 
(442) 
(443) 
(434) 
(435) 
(436) 
(437) 


ic 


( 

7 
I 4 
4 

( 
1 


TPITTTTTTT TT 7 


g — (AC) 


— 117777777777 , —» (AC) 


8 
777777777777, + (E) 


777717777777, > (AC), (E) 
(AC) 0 (E) + (AC) 
(AC) a E —» (AC) 


(AC) a (E) > €E) 


(AC) ~ (E) > (AC), (E) 


(AC)! a (E) — (AC) 
(AC)' a E — (AC) 

(AC) « (E) + (€) 

(AC)' a (E) -» (AC), (E) 


(AC) p (E)! -» (AC) 
(AC) , E' — (AC) 

(AC) a (E)' — (E) 

(AC) a (E)' — (AC), (E) 


(AC)'a (E)! — (AC) 
(AC)' «4 E' -> (AC) 
(AC)" 4 (E)! — €) 
(AC)" 4 (E)' (AC), () 


(AC) v (E) + (AC) 
(AC) v E - (AC) 

(AC) v (E) -» (E) 

(AC) v (E) -» (AC), (E) 


(AC)' v (E) -» (AC) 
(AC)! y E > (AC) 

(AC)' v (E) — (E) 

(AC)" v (E) — (AC), (E) 


(AC) v (E 


)' > (AC) 
(AC) v (E) 
) 


 —» (AC) 
‘= {E) 
— (AC), (F) 


(AC) v (E 
(AC) v (E)! 
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ra 190 
| 1ORCB 7 (AC)! v (E)!' > (AC) 





| ~ 1ORCBI (AC)' v Et > (AC) 

| |ORCBM 2 (AC) v (E)'» 

_ VORCBB j (AC)! v (E)' > (AC), (E) 
XOR (430) (AC) @ (E) -» (AC) 
XORI (431) (AC) @ E - (AC) 
XORM (432) (AC) @ (E) -» () 

XORB (433) (AC) @ (E) > (AC), (E) 
EQV (444) (AC) @ (E)]" > (AC) 
EQVI (445) (AC) @ E]* - (AC) 
EQVM (446) (AC) ® (E)|' —» (E) 
EQVB (447) (AC) \@ cE) — (AC), (E) 


Shifting 


Arithmetic shifts perform 2's complement multiplication. Overflow may occur when shifting left. Logical 
shift inserts O's at one end and bits at the other end are lost. Rotate forms a ring so that bits are recycled. 
The number of shifts is designated by E (considered as a 2's complement number). The direction is to the 


left if E is positive; to the right if E is negative. 


ASH (240) arithmetic shift 
ROT (241) rotate 
LSH (242) logical shift 


shift (AC) 


shift Combined accumulators, 


(AC) and (AC+1). (AC) is in | 


the high order position. 

During arithmetic shifts the 
sign of AC+1 is set to the sign 
of AC, if the shift is non-zero. 





Instruction Codes 


ASH (240) arithmetic shift 

ASHC (244) arithmetic shift combined 
accumulators 

ROT (241) rotate 
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ROTC (245) rotate combined accumulators 
LSH (242) logical shift 
LSHC (246) logical shift combined accumulators 


DATA TRANSMISSION 


Full Word 
MOVE (200) move full word 
MOV S (204) move swapped word 
(left and right halves exchanged) 
MOVN (210) move full word negative 
(2's complement) 


MOVM (214) move full word magnitude 


source: (E) 


destination: (AC) 
Immediate 
source: (O,E) 
destination: (AC) 
Memory 

source: (AC) 
destination: (E) 
Self 


source: (E) 





destination: (E) | 
and also (AC) if the AC address is non-zero 


Instruction Codes 


MOVE (200) (E) — (AC) 
MOVEI (201) E— (AC), 

0 = (AC), 
MOVEM (202) (AC) — (E) 
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MOVES 


MOVS 


MOV Sl 


MOV SM 


MOV SS 


MOVN 
MOVNI 
MOVNM 
MOVNS 


MOVM 
MOVMI 
MOV MM 
MOVMS 


Miscellaneous Full Word 


EXCH 
BLT 


(203) 


(204) 


(205) 


(206) 


(207) 


(250) 
(251) 


(E) — €) 
(E) > (AC) if AC 40 


(E), > (AC), 
(E)p > (AC), 


QO- (AC), 
E —» (AC), 


(AC), > Ep 
(AC), > (6), 

(), > ©p 

©), ©), 

(E), > (AC), and (E)p — (AC), 


if AC 40 
-(E) - (AC) 

-E —» (AC) 
-(AC) —» (E) 
-(E) — (E) 

-(E) —» (AC) if AC 40 
|(E) | > (AC) 

E —» (AC) 
|(AC)| — (E) 
IE) | > (E) 

I(E)| + (AC) if AC 40 


(E) «—» (AC) 

Block Transfer E-({AC) +1 
words from locations starting at 
(AC), to locations starting at 
(AC) 

Note: if a priority interrupt 


occurs during this instruction 
then (AC) are indeterminate. 
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Half-Word 


Half word transmission instruction codes are composed of a modifier and the mode. 


HLL 
HRR 
HRL 
HLR 









MODIFIER 





(500) half word left to left 
(540) half word right to right 
(504) half word right to left 
(544) half word left to right 


none 
set other half of destination word to Zeros 
set other half of destination word to Ones 


Extend sign of destination half-word to 
other half 





source: (E) 
destination: (AC) 
Immediate 
source: (0, E) 


destination: (AC) 


Memory 

source: (AC) 
destination: (E) 
Self 


source: (E) 
destination (E) 
and also (AC) if the AC field is non-zero 
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Instruction Codes 


HLL 


HLLI 


HLLM 


HLLS 


HRR 


HRRI 


HRRM 


HRRS 


HRL 


HRLI 


HRLM 


HRLS 


HLR 


HLRI 


HLRM 


HLRS 


HLLZ 


HLLZI 


HLLZM 


HLLZS 


(500) 
(501) 
(502) 


(503) 


(540) 
(541) 
(542) 


(543) 


(504) 
(505) 


(506) 


(507) © 


(544) 
(545) 
(546) 


(547) 


(510) 


(511) 


(512) 


(513) 


(E), > (AC), 
0O- (AC), 
(AC), > (©), 


(E), — (E) 
L L 


(Ep > (AC)p 
—E—~ (AC), 
(AC) Ep 
Ely Ep 
(E)p > (AC), 
E ~» (AC), 
(AC), (E), 
E> ©), 
), > AC) 
O— (AC), 
(AC), > Ep 
), 7 ©e 
(E), 7 (AC), 
O— (AC), 


Oe (AC), 
= (AC), 


(AC), — (E), 
0 (), 
(&), > (€), 


O—- (E), 
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HRRZ (550) (E), > (AC), 


O— (AC), 
HRRZI (551) E- (AC), 

0 — (AC), 
HRRZM (552) (AC), ~ (E), 

0 (E), 
HRRZS (553) — (E),  (E)p 

OG); 
HRLZ (514) (EE), (AC), 

0 - (AC), 
HRLZI (515) E- (AC), 

0 + (AC), 
HRLZM (516) (AC), > (E), 

0o—- (E), 
HRLZS (517) (E), 7 (E), 

O- (), 
HLRZ (554) (E), 7 (AC), 

O— (AC), 
HLRZI (555) 0 - (AC), 

0 + (AC), 
HLRZM (556) (AC), = (E), 

O— (E), 
HLRZS (557) (E), > (E)p 

Oo—- (E), 
HLLO (520) (E), ? (AC), 


777777, -» (AC)q 
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HLLOI| 


HLLOM 


HLLOS 


HRRO 


HRRO| 


HRROM 


HRROS 


HRLO 


HRLOI 


HRLOM 


HRLOS 


HLRO 


HLROI 


(521) 


(522) 


(523) 


(560) 


(561) 


(562) 


(563) 


(524) 


(525) 


(526) 


(527) 


(564) 


(565) 


O- (AC), 


777777,» (AC) 


(AC), > ©), 


R 


ee Page AF 
©,> ©, 
777777,» (E)p 
(Ep (AC), 
777777, + (AC), 
—E— (AC)» 
17777. — (AC), 
(AC), + (Ep 
777777, + (E), 
Ee Op 
777777, (E), 
(, (AC), 


777777, (AC) 
—E— (AC), 
777777,» (AC) x 
(AC), > (E), 
THTTTT OA) 
E)p— (), 
117177 ~ (FE), 
(E), > (AC), 
177777 — (AC), 
—E— (AC), 


TUTTE MAC), 
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HLROM 


HLROS 


HLLE 


HLLE] 


HLLEM 


HLLES 


~ HRRE 


HRRE| 


HRREM 


HRRES 


HRLE 


HRLEI 


HRLEM 


(566) 


(567) 


(530) 


(531) 


(532) 


(533) 


(570) 


(571) 


(572) 


(573) 


(534) 


(535) 


(536) 


(AC), 7 (E), 
TTT TD PE) 
(FE), > (Dp 


Tilda (Ey, 


L 


(E), > (AC), 
(E)y + (AC), 
0 -» (AC), 

0 + (AC), 
(AC), + ©), 
(AC), — (E), 
&) > ©), 
E+ Op 
(Ep * (AC)p 
(E37 AC), 
E— (AC), 
Fig AC), 
(AC) (Ep 
(Ac). (©) 
E),* Ep 
©,,7 ©, 
(E), > (AC), 
Eo (AC)p 
E + (AC), 
Fig” AO 
(AC)p > (E), 


(AC) a (Ep 
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HRLES (537) (E)p a (E), 


Eg), 


HLRE (574) (E), @ AC), 
(E)) 7 (AC), 
HLRE| (575) O = (AC), 
0 (AC), 
HLREM = — (576) (AC), (E)p 
(AC), (E), 
HLRES (577) (E), 7 €), 
(FE) ), 


Byte Manipulation 


Byte manipulation instructions permit easy access to any number of contiguous bits anywhere ina single 
word, The size (S) and location (P) of the byte are specified by a pointer word designated by the 


effective address: 


13 
¢) 56 't | 14 17 18 35 


Las 


Byte Pointer Word 


The 1, X, and Y-fields of the pointer word are used in the usual manner to computer an effective 

address which is the location of the memory word containing the byte. The P=field specifies the number 
of bits between the right end of the word and the farthest right bit of the byte. The S-field specifies 

the size of the byte, up to 36 bits. To store and retrieve successive bytes, the pointer word incrementing 
instructions automatically subtract the size of the byte from P, moving the position to the right by one 
byte. If there is insufficient room in the memory word for the next byte (P-S<O), the Y-field of the 


pointer word is incremented by 1 and P is reset to 36-S. 


This instruction may be interrupted between incrementing and the byte operation. The byte increment 
suppression (BIS) flag records the incrementing operation, and prevents its occurrence when returning from 


an interrupt. Note that this flag is under program control, and is restored by the JRST instruction, 
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Instruction Codes 


LDB 


DPB 


IBP 


ILDB 


IDPB 


EXECUTIVE 


Arithmetic Compare and Modify 


(135) 


(137) 


(133) 


(134) 


(136) 


LoaD Byte 


The byte is loaded into the 
accumulator right justified. 
Unused bits in the accumulator 
are cleared, 


DePosit Byte 


The byte in the accumulator is 
deposited in the memory word. 
Unused bits in the memory 
word are not affected, and the 
unused bits in the accumulator 
need not be zero. 


Increment Byte Pointer 


if P-S >0 then P-S — P 
if P-S <0 then Y+1 + Y 
and 36-S — P 


Increment and LoaD Byte 
Same as IBP followed by LDB 
Increment and DePosit Byte 


Same as IBP followed by DPB 


SKIP tests the (E) against 0 and skips 1 instruction location if the conditions specified by the mode are 
satisfied. AOS and SOS add 1 or subtract 1 from (E) before testing. JUMP tests the designated 
accumulator, AOJ and SOJ add 1 or subtract 1 from (AC) and then jump if the test is satisfied. 


SKIP 


JUMP 
AOS 
SOS 


AOJ 
SOJ 


(330) 


(320) 
(350) 
(370) 


(340) 
(360) 


SKIP if conditions specified by 
the mode are satisfied by (E). 
(E) — (AC) if ACO. 


JUMP if conditions specified by the 
mode are satisfied by (AC). 


Add One to memory and Skip. 
(E)+1 -» (AC) if ACO. 


Subtract One from memory and 


Skip. (E)-1 —» (AC) if ACZO0. 
Add One to (AC) and Jump. 
Subtract One. from (AC) and Jump. 
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CAM (310) Compare Accumulator to 
Memory and skip. 


CAI (300) Compare Accumulator Imme-~ 
diate and skip. 


never 

Less than 
Equal to 

Less than or Equal 


Always 


Greater than or Equal 


Not equal 


Greater than 





Instruction Codes 


SKIP (330) (E) -» (AC) if AC40 

SKIPL (331) (E) —» (AC) if AC40 
skip if (E) <0 

SKIPE (332) (E) —» (AC) if ACA0 
skip if (E)=0 

SKIPLE (333) (E) (AC) if AC40 
skip if (E) <0 

SKIPA (334) (E) — (AC) if ACZ0 
always skip 

SKIPGE (335) (E) —» (AC) if AC40 
skip if (E) >0 

SKIPN (336) (E) —» (AC) if ACO 
skip if (E)40 

SKIPG (337) (E) -- (AC) if ACO 
skip if (E) >0 

JUMP (320 No action 

JUMPL (321 E —» PC if (AC) <0 


JUMPE (322 
JUMPLE (323 


E —» PC if (AC) =0 
E -» PC if (AC) <0 


ee ee eee 
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JUMPA 
JUMPGE 
JUMPN 
JUMPG 


AOS 


AOSL 


AOSE 


AOSLE 


AOQSA 


AOSGE 


AOSN 


AOSG 


SOS 


SOSL 


SOSE 


(352) 


(353) 


(354) 


(355) 


(356) 


(357) 


(370) 


(371) 


(372) 


E— PC 
b= PCiPAC) > 0 
E —> PC if (AC) 40 
E —» PC if (AC) > 0 


(+17 €) 


result ~* (AC) if AC # 0 
Cee iE) 

result —» (AC) if AC #0 
skip if result < 0 

(E) Te (E) 

result + (AC) if AC #0 
skip if result = O 

(E} + 1 —» (E) 

result — (AC) if AC #0 
skip if result < 0 

(E)+ 1—> (E) 

result —» (AC) if AC 40 
always skip 


(E) + 1 —» (E) 


result — (AC) if AC 40 


skip if result > 0 

(E) + 1 —» (E) 

result ~» (AC) if AC 40 
skip if result 4 0 

(E) + 1 —» (E) 

result —» (AC) if AC 40 
skip if result > 0 


(E) - 1» (E) 

result —» (AC) if AC 40 
GE enc le (E) 

result —» (AC) if AC 40 
skip if result <0 

(E)~ 1 > €€) 

result —» (AC) if AC 40 
skip if result = 0 
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SOSLE 


SOSA 


SOSGE 


SO SN 


SOSG 


AOJ 


AOJL 


AOJE 


AOJLE 


AOJA 


AOJGE 


AOJN 


AOJG 


sOJ 
SOJL 


SOJE 


(373) 


(374) 


(375) 


(376) 


(377) 


(340) 


(341) 


(342) 


(343) 


(344) 


(345) 


(346) 


(347) 


(360) 
(361) 


(362) 


Ss ae ia | 

result —» (AC) if AC 40 
skip if result <0 

(E)- 1 — €) 

result —» (AC) if AC #0 
always skip 

(E) - 1 — (E) 

result —» (AC) if AC 40 
skip if result > 0 

(E) - 1 — (E) 

result -» (AC) if AC 40 
skip if result 4 0 

(—)-1 > €) 

result - (AC) if AC 40 
skip if result > 0 

(AC) + 1 —» (AC) 

(AC) +1 — (AC) 

E -—» PC if result <0 
(AC) + 1 —» (AC) 

E-—» PC if result = 0 
(AC) + 1— (AC) 

E— PC if result <0 
(AC) + 1 — (AC) 

E-=? PC 

(AC) +1 — (AC) 

E> PCit resuir 20 
(AC) + 1 -» (AC) 

E -—» PC if result 40 
(AC) + 1 — (AC) 

E> PC if result >0 
(AC) - 1 — (AC) 

(AC) - 1 — (AC) 

E —» PC if result <0 
(AC) - 1 -—» (AC) 

E —» PC if result = 0 
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SOJLE 


SOJA 


SOJGE 


SOJN 


SOJG 


CAM 
CAML 
CAME 
CAMLE 
CAMA 
CAMGE 
CAMN 
CAMG 


CAI 
CAIL 
CAIE 
CAILE 
CAIA 
CAIGE 
CAIN 
CAIG 


(363) 


(364) 


(365) 


(366) 


(367) 


(310) 
(311) 
(312) 
(313) 
(314) 
(315) 
(316) 
(317) 


(300) 
(301) 
(302) 
(303) 
(304) 
(305) 
(306) 
(307) 


(AC) - 1 — (AC) 
Bre iesuir< 0 
(AC) - 1 — (AC) 
ae a 2 

(AC) - 1 - (AC) 

E -* PC if result >0 
(AC) - 1 — (AC) 

E —» PC if result 4 0 
(AC) - 1 — (AC) 

E —» PC if result >0 


No action 

skip if (AC) < (E) 
skip if (AC) = (E) 
skip if (AC) < (E) 
always skip 

skip if (AC) > (E) 
skip if (AC) # (E) 
skip if (AC) > (E) 


No action 

skip if (AC) <E 
skip if (AC) =E 
skip if (AC) <E 
always skip 
skip if (AC) >E 
skip if (AC) #E 
skip if (AC) >E 


The following two instructions add 1 to both halves of (AC) and then test and jump. There are no mode 


codes, 


AOBJP 


AOBJN 


(252) 


(253) 


Add One to Both and Jump if Positive 
(AC) + 1000001 3 — (AC) 

E —» PC if result > 0 

Add One to Both and Jump if Negative 
(AC) + 1000001 , — (AC) 

E -— PC if result <0 
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Logical Compare and Modify 


Accumulator bits corresponding to |-bits in a mask can be modified or tested to determine a skip. The 


source of the mask is designated by the second letter of the instruction code mnemonic: 


Direct memory word specified by (E) 
(E) with right and left halves Swapped 
A word with E in the Left half, zeros in the right half. 


7A - nN YO 


A word with E in the Right half, zeros in the left half. 


The masked bits of the accumulator may be modified as indicated by the third letter of the instruction 
mnemonic: 

No modification 

set masked bits to Zero 


set masked bits to One 


Yon Zz 


Complement masked bits 


The skip condition is specified by the mode (fourth letter of mnemonic). 


never skip 


all masked bits are Equal to zero 


Always skip 


Not all masked bits equal to are zero 





Instruction Codes 


TDN (610) No action 

TDNE (61 2) skip if (AC) 4 (E) =0 
TDNA (614) always skip 

TDNN (616) skip if (AC) 4 (E) £0 
TSN (611) No action 

TSNE (613) skip if (AC) 4 (E). = 
TSNA (615) always skip 

TSNN (617) skip if (AC) “ (E), #0 
TLN (601) No action 

TLNE (603) skip if (AC), * E=0. 
TLNA (605) always skip 
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TLNN 
TRN 
TRNE 
TRNA 
TRNN 
TDZ 
TDZE 
TDZA 


TDZN 


TSZ 
TSZE 


TSZA 
TSZN 


TLZ 


TLZE 
TLZA 
TLZN 


TRZ 


TRZE 
TRZA 


TRZN 


(607) 
(600) 
(602) 
(604) 
(606) 
(630) 
(632) 
(634) 


(636) 


(631) 
(633) 


(635) 
(637) 


(621) 


(623) 


(625) 


(627) 


(620) 


(622) 


(624) 


(626) 


skip if (AC), ® EZO 
No action 

skip if (AC), eee, 
always skip 

skip if (AC), “ E40 
(AC) * (E)' — (AC) 
skip if (AC) “ (E) = 0 
(AC) * (E)' - (AC) 
always skip 

(AC) *(E)! -» (AC) 
skip if (AC) “ (E) #0 
(AC) “(E)' — (AC) 
(AC) “{E). > (AC) 
skip if (AC) “ (F), = 0 
(AC) *(E), = (AC) 
always skip 

(AC) *(E). = (AC) 
skip if (AC) A (E), x0 
(AC) *(E)', — (AC) 
(AC), AE! ms (AC), 
skip if (AC), ES © 
(AC), AE'— (AC), 
always skip 

(AC), AEi— (AC), 
skip if (AC), VEG 
(AC), SUEY (AC), 
(AC), AEt— (AC), 
skip if (AC), 3 oe 8, 
(AC), AEt ms (AC), 
always skip 

(AC), AEl— (AC), 
skip if (AC), ge meen, 
(AC), AE! — (AC), 
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TDO 
TDOE 


TDOA 
TDON 


TSO 
TSOE 


TSOA 


TSON 


TLO 


TLOE 


TLOA 


TLON 


TRO 


TROE 


TROA 


TRON 


TDC 
TDCE 


(670) 
(672) 


(674) 
(676) 


(671) 
(673) 


(675) 


(677) 


(661) 


(663) 


(665) 


(667) 


(660) 


(662) 


(664) 


(666) 


(650) 
(652) 


(AC) v (E) -* (AC) 
skip if (AC) 4 (E) = 0 
(AC) v (E) - (AC) 
always skip 

(AC) v (E) — (AC) 
skip if (AC) * (E) 40 
(AC) v (E) - (AC) 
(AC) v (E), (AC) 
skip if (AC) * (FE). = 0 
(AC) v (E). ~» (AC) 
always skip 

(AC) v (FE), + (AC) 
skip if (AC) “ (E) #0 
(AC) v (E). — (AC) 


(AC), veo (AC), 


skip if (AC), 4 E = 0 
\ 
(AC), v E (AC), 


always skip 

(AC), Vio (AC), 
skip if (AC), NEO 
(AC), vEo (AC), 
(AC), as (AC), 


skip if (AC), AE =0 
(AC), v E (AC), 


always skip 
(AC), veo (AC), 


skip if (AC) AE £0 
(AC), v E > (AC), 


(AC) ® (E) - (AC) 


skip if (AC) * (E) =0 


(AC) ® (E) ~ (AC) 
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TDCA 
TDCN 


TSC 
TSCE 


TSCA 


TSCN 


TLC 


TLCE 


TLCA 


TLCN 


TRC 


TRCE 


TRCA 


TRCN 


Inter-Program Transfer 


(654) 
(656) 


(651) 
(653) — 


(655) 


(657) 


(641) 


(643) 


(645) 


(647) 


(640) 


(642) 


(644) 


(646) 


always skip 

(AC) @ (E) -* (AC) 
skip if (AC) 4(E) 40 
(AC) ® (E) — (AC) 
(AC) @ (E). -* (AC) 
skip if (AC) 4 (E). = Q 
(AC) ® (E) —> (AC) 
always skip 

(AC) ® (E), > (AC) 
skip if (AC) 4 (E)S 40 
(AC) @ (E) — (AC) 
(AC), @E- (AC), 
skip if (AC), ESO 
(AC), @E- (AC), 
always skip 

(AC), @E- (AC), 
skip iF (AC), AE 40 
(AC), ® E = (AC), 
(AC), @E- (AC), 
skip if (AC), ae 
(AC), @E — (AC) R 
always skip 

(AC), @Q@E-~ (AC), 
skip if (AC), KEG O 
(AC), @E- (AC), 


In the following descriptions, a reference to flags refers to a half-word quantity described as follows: 


bit 0: 
bit 1: 
bit 2: 
bit 3: 
bit 4: 


AROV 
CRYO 
CRY1 
FOV 
BIS 


bit 5: User Mode 

bit 6: User Mode IOT 
bit 11: FXU 

bit 12: DCK 


and Os elsewhere. 
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JSR 


JRST 


JSP 


JSA 


JFFO 


(264) 


(254) 


(265) 


(266) 


(243) 


Jump to SubRoutine 
flags — (E), 


Pe sae), 


then E+ 1 — PC 
Jump and ReSTore 


This instruction may be used 
as the return from a JSR or 
JSP. The AC~-field determines 
additional functions: 

If AC10 (bit 9 = 1) reset the 
current priority interrupt 
channel. 7 


‘If AC4 (bit 10 = 1) then halt 


If AC2 (bit 11 = 1) then 
restore flags. Indirect 
addressing or indexing must be 
specified if AC2 is designated. 
If AC] (bit 12 = 1) then set 


user mode flag. 


Jump and Save Program 
counter 


PC. (AC), 
flags — (AC), 


E—» PC 


Jump and Save Accumulator 
(see JRA for return) 


(AC) -» (E) 
PC — (AC), 


E— (AC) 
L 
E+]—+ PC 


Jump if Find First One 
If (AC)= 0,0 —- AC +1 
If (AC) #0, 


[ the bit position of the leftmost 1 of (AC) ] — AC +1 
E—» PC 
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JRA 


JFCL 


(267) 


(255) 


Jump and Restore Accumulator 
(used as a return for JSA) 


E — PC 
((AC),) + (AC) 


Jump and Clear Flags if any 
flag selected by the AC field 
isa 1 then E — PC and the 
selected flags are cleared 
AC-field flag assignments. 
bit 9: arithmetic overflow 
bit 10: carry 0 

bit 11: carry 1 

bit 12: floating overflow 


Note: See PUSHJ and POPJ under pushdown operations for completely recursive subroutine operations. 


Push Down List 


The push down overflow flag is set if a carry from bit 0 of the accumulator occurs during incrementing 


or decrementing. Bit assignments for flags are shown under the inter-program transfer instructions. 


PUSH 


POP 


PUSHJ 


POPJ 


XCT 


(261) 


(262) 


(260) 


(263) 


(256) 


PUSH 


(AC) + 1000001 , —» (AC) 
then (E) ((AC)p) 

POP 

(AC,) + (E) 

then (AC)- 1000001 , —» (AC) 
PUSH and Jump 

(AC) + 1000001 a (AC) 
then PC — (AC) ,) 

flags — (AC), ) 

E-—» PC 

POP and Jump 

((AC)p)g 7 PC 

then (AC)- 1000001 ,, ~» (AC) 


Execute 


execute the instruction at (E). 
This may be another XCT 


instruction 
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INPUT/OUTPUT 


Input/output instructions address devices connected to the input/output bus. Each device contains a 


device status register (DSR) which records commands from the central processor and contains the status 


of the device (e.g. interrupt request, activity, errors). Data is transferred through the data buffer 


register (DBR) located at the device, and may consist of from one to 36 bits depending upon the nature 


of the device. The central processor and the priority interrupt system are regarded as devices (addresses 


000 and 004, respectively). 


CONO 
CONI 
DATAO 
DATAI 


CONSZ 


CONSO 


BLK! 


(700) 
(700) 
(700) 
(700) 


(700) 


(700) 


(700) 


CONditions Out 
E — (DSR) 
CONditions In 
(DSR) —» (E) 
DATA Out 

(E) -» (DBR) 
DATA In 

(DBR) — (E) 


CONditions in and 
Skip if Zero 


skip if (DSR) AE =0 


CONditions in and 
Skip if One 


skip if (DSR) A E #0 
BLocK In 


The effective address is used 
to locate a pointer word. The 
left half of the pointer word 
contains the word count and 
the right half holds the 
operand address. 


(E) + 1000001, — (E) 
then (DBR) -+ ((E),) 


If not executed In a priority 

interrupt cycle, then skip 

if a carry occurred from bit 0 

when incrementing the pointer 

word, If in priority interrupt 
cycle and overflow occurred then 
execute next instruction after trap 
location. If in program interrupt 
cycle and overflow did not occur, then 


dismiss interrupt and return to the inter- 


rupted sequence. 
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BLKO (700) BLocK Out 


same as BLKI except 


((E),) - (DBR) 


Central Processor 


The central processor is addressable as an input/output device with address 000,,. The input/output 
instructions are used for console operations, loading the memory protection and relocation registers, 


and processing machine flags. MACRO-10 assembly language notation is used in the following discussion. 


DATAI APR, ADDRESS 


The contents of the console data switches are stored in the effective address. 


DATAO APR, ADDRESS 


Bits 18-25 of the contents of the effective address are stored in bits 18-25 of the relocation register. 


Bits 0-7 are stored in bits 18-25 of the memory protection register. 


CONI APR, ADDRESS 


The contents of the effective address bits 19-35 are replaced. Unused bit positions are cleared. 


33-35 processor interrupt channel assignment 
32 arithmetic overflow flag 

31 arithmetic overflow interrupt enable flag 
30 not used 

29 floating overflow flag 

28 floating overflow interrupt enable flag 
27 not used | 

26 clock flag 

25 clock interrupt enable flag 

24 not used 

23 non-existent memory flag 

22 memory protection violation flag 

21 address break flag | 

20 user mode IOT flag 

19 push down overflow flag 
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CONO APR, ADDRESS 


The bits of the effective address, E, perform the indicated functions. 


(E) bit 


33-35 
32 
3] 
30 
29 
28 
27 
26 
25 
24 
23 
22 
2] 
20 
19 
18 


Priority Interrupt System 


Function 


assigns the processor to an interrupt channel 
clears arithmetic overflow flag 

sets arithmetic overflow interrupt enable flag 
clears arithmetic overflow interrupt enable flag 
clears floating overflow flag 

sets floating overflow interrupt enable flag 
clears floating overflow interrupt enable flag 
clears clock flag 

sets clock interrupt enable flag 

clears clock interrupt enable flag 

clears non-existent memory flag 

clears memory protection violation flag 
clears address break flag 

not used 


transmits a reset signal to all |/O devices 


clears push down overflow flag 


The priority interrupt system is addressable as device 004, (Pl). 


DATAI PI, ADDRESS 


Zeros are stored in (E). 


DATAO PI, ADDRESS 


The (E) are displayed at the console on the memory indicator lights. 


CONI PI, ADDRESS 


The (E) are replaced. Unused bit positions are cleared. | 
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(E) bit 


35 


29 
28 
27 


2| 

20 
19 
18 


CONO PI, ADDRESS 


Value 


channel 7 has been enabled 


channel 1 has been enabled 
priority interrupt system fs on 


interrupt in progress on channel 7 


interrupt in progress on channel 1 
memory parity error interrupt enable flag 
memory parity error flag 


power failure flag 


The (E)p perform the indicated functions. 


(E) bit 


35 


29 
28 
27 
26 

25 
24 
23 
22 
21 
20 
19 
18 


Function 


selects channel 7 for bits 24, 25, 26 


selects channel 1 for bits 24, 25, 26 

turn on priority interrupt system 

turn off priority interrupt system 

disable selected channel 

enable selected channel 

initiate an interrupt on selected channel 
clear (reset) priority interrupt system 

not used 

set memory parity error interrupt enable flag 
clear memory parity error interrupt enable flag 
clear memory parity error flag 


clear power failure flag 
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ey) 
SuBtract 
MULtiply 
integer MULtip!ly 
Divide 


Integer DiVide 


Floating ADd 
Floating SuBtract 
Floating MultiPly 
Floating DiVide 


Floating SCale 
Qouble Floating Negate 
Unnormalized Floating Add 


Zeros 

Ones 

Accum. 
Memory 
Comp. Accum. 
Comp. Memory 


EQuiValence 
eXclusive OR 


~ 
Comp. Accum. 
Comp. Memory 
Comp. Both 


AND 
inclusive OR 


Arithmetic SHift ~ 
Logical SHift Combined 
ROTate 


Jest accum. with 


Jump to SubRoutine in memory, 


save program counter/status in memory. 


INSTRUCTION LIST 


~ 
immediate 
Memory 
Both 


~ 
Long 
Memory 
Both 


nN 
immediate 
Memory 
Self 


Direct memory 

Swapped memory set 
Right immediate 

Left immediate 


Jump, Save Program counter/stctus in accum. 


Jump, Save Accum. in memory, 


save program counter/status in accum. 


Jump, Reset Accum. from memory. 
dump on Flags, Clear flags. 
Jump and ReSTore flags. 


3 

Negate 

Magnitude ww 
immediate 
Memory 


Self 


Swap 


Right 
Left 


Right 
Left 


Block Transfer 


EXCHange accum.-~memory 


~ LoaD Byte 
Increment DePosit Byte 


increment Byte Pointer 


~ 

Less 

Equal 

Less or Equal 
Alwoys 

Greater 

Greater or Equal 
Not equal 


Add Qne and Skip 
Add One and Jump 
Subtract One and Skip 
Subtract One and Jump 


Compare Accum. with Memory 
Compare Accum. immediate 


Add One to Both halves and Jump if Positive 


Negative 


Nothing Nw 
Zeros 
Ones 
Complement 


Always 
if Equal O 
if Not O 


eXeCuTe instruction from memory 


CONGitions dn 

Qut 

Skip if Zeros 
, Skip if Ones 


In 
Out 
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(A) 
(A), 
(A), 
(A). 


Oo < => 


Xx 


| 
(A) —¥ (8) 


AC 


SYMBOLS 


contents of A 
left half of (A) 
right half of (A) 


contents of A with left and right 
halves swapped 


boolean AND 

boolean inclusive OR 
boolean exclusive OR 
boolean inversion 
arithmetic addition 
arithmetic subtraction 
arithmetic multiplication 
arithmetic division 
arithmetic magnitude 


contents of A replaces contents of B 


~ accumulator 


effective address 
equal 


not equal 
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MACRO ASSEMBLY STATEMENTS 


Symbols 


Direct Assignment Statement 


Numbers 


1. One to six characters in length 


2. Composed of characters from the set: 

A through Z 

0 through 9 

$ (dollar sign) 

% (percent symbol) 

(point) 

First character cannot be a digit; if first char- 
acter is a period, second character cannot be 
a digit. No imbedded spaces are allowed. 


symbol = value 


2< radix < 10 


RADIX statement - Used to set radix for numbers 
which follow 


To set radix for single numeric term: 


* Dan Decimal 
®Onn Octal 
4ABnn Binary 


Binary shifting: 


nnBb Place the number nn in a word, 
placing the rightmost bit of 
the number in bit "b’ 


~nnBb Same as above but store the 
2's complement of the number 


Floating point decimal numbers: 


nnnEe Store the number as a floating 
point decimal number with the 
signed exponent "e" 


Any string of digits containing 
a decimal point is also stored 

_as a floating point decimal 
number. 


Fixed point decimal numbers: 


?#Fnnn.nnBb Assembler places value into 

two 36-bit registers, with the 
integer portion in the left reg- 
ister and the fractional portion 
in the right register. The value 
is then stored in one word, with 
the assumed decimal point set 
after bit "b" in the storage word. 
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Address Assignments 


Primary Instruction Format 


ACCU 


IND 


Arithmetic and Logical Operators: 


a Add 

- Subtract 
. Multiply 
ip Divide 
& AND 


Inclusive OR 
Order of Evaluation: 


Expressions enclosed in angle brackets, 
beginning with the innermost pair 


Unary operations (leading + or -) 
Binary shifts 
Logical operations (left to right) 
Multiplication and division (left to right) 
Addition and subtraction (left to right) 
Numeric term: a digit, a string of digits, or an 
expression enclosed in angle brackets 
Assigns addresses consecutively 
Location counter: . (point) 
Indirect addressing: @ adr 
Indexing adr(n) where n = 1 through 17 


Literal: | data-generating expression| 


{3 
0 89 12 | 14 17 18 Lo ae 


INSTRUCTION i 
PART | 
MULATOR 


IRECT BIT 


INDEX 
REGISTER 


ADDRESS 
PART 
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Input/Output Instruction Format 


1/0 nero! 


DEVICE 
SELECTION 


INSTRUCTION 
PART 


INDIRECT BIT 


INDEX 
REGISTER 


ADDRESS 
PART 


13 
a aco 12 = 17 18 
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SUMMARY OF PSEUDO-OPS 


ASCII . 
ASCIZ 
BLOCK 
BYTE 
DEC 
DEFINE 
DEPHASE 
ENTRY 
EXP 
EXTERN 


Conditional Assembly Statements 


FI 
IF2 
IFB 
IFDEF 
IFDIF 
IFE 
IFG 
IFGE 
IFIDN 
IFL 
IFLE 
IFN 
IFNB 
IF NDEF 

INTERN 

IOWD 

IRP 

LALL 

LIST 


Seven~bit ASCII text. 
Seven-bit ASCII text, with null character guaranteed at end. 
Reserves block of storage cells. 

Input bytes of length | through 36 bits. 
Input decimal numbers. 

Defines macro. 

Terminates PHASE relocation mode. 
Enters subroutine library. 

Input expressions. 


Identifies external symbols. 


Assemble if: 


Encountered during pass |. 
Encountered during pass 2. 
Blank 

Defined 

Different 

Zero 

Positive 

Zero, or positive 
Identical 

Negative 

Zero, or negative 
Non=zero 

Not blank 

Not defined 


_ Define internal symbols. 


Set up I/O transfer word. 
Indefinite repeat of macro arguments. 
List all; expanded listing. 


Implied at end of pass 2. — 
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LIT 

LOC 
NOSYM 
OCT 
OPDEF 
PAGE 
PASS2 
PHASE 
POINT 
PRINTX 
PURGE 
RADIX 
RADIX50 
RELOC 
REMARK 
REPEAT 
RIM 
RIMI0 
RIM10B 
SIXBIT 
STOPI 
SUBTTL 
SYN 
TITLE 
VAR 
XALL 
XLIST 
XWD 

Z 


Assemble literals 

Assign absolute addresses. 

Suppress symbol table listing. 

Input octal numbers. 

Defines user-created operator. Generates only one word. 
Skip to top of next page. 

Terminates pass | remaining statements are processed pass 2 only. 
Following coding relocated at execution time. 

Sets up byte pointer word. 

Prints when encountered during pass |. 

Purge symbols 

Sets prevailing radix to 2-10. 

Compresses 36-bit words, primarily for system use. 
Implied first statement; assigns relocatable addresses. 
Comments only statement. 

Repeat n times 

Prepare output In RIM paper—tape format. 

Absolute, unblocked, output format. No checksums. 
Absolute, blocked, checksummed output format. 
Input text in compressed 6-bit ASCII. 

Stop indefinite repeat of macro arguments. 

Subtitle on listing. 

Make synonomous 

Title on listing. 

Assemble variables suffixed with *. 

Stop expanded listing. 

Stop listing. | 

Input two 18-bit half words. 


Input zero word. 
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SUMMARY OF CHARACTER INTERPRETATION 


The characters listed below have special meaning in the contexts indicated. These inter- 


pretations do not apply when these characters appear in text strings, or in comments. 


Character 


Ist character 
of text string 


Meaning 
Colon. Immediately follows all labels. 
Semi=colon. Precedes all comments. 


Point. Has current value of the location 
counter. 


Comma. General operand or argument 
delimiter. 


Accumulator field delimiter 


References accumulator 0. The 
comma is optional, — 


Delimits macro arguments. 
Inclusive OR 
AND Logical Operators 
Multiplication 
Division 
Add Arithmetic Operators 
Subtract 
In ASCII, ASCIZ and SIXBIT test strings, 


the first non-blank character js the 
delimiter. 


Follows number to be shifted and pre- 
cedes binary shift count. 


Exponent. Precedes decimal exponent 
in floating-point numbers. 


Parentheses. Use to enclose index fields. 


Enclose the byte size in BYTE 
statements. , 


Enclose the dummy argument string 
in macro DEFINE statements. 
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Example 
LABEL: Z 
THIS IS A COMMENT 


JRST .+5 Jump forward five 
locations. 


DEC 10, 5, 6 
EXP A+B, C-D 


MOVEI 1, TAG 
MOVEIL, TAG 


MACRO (A,B,C) 


ASCII/STRING/; 


7B2 
F22.1E5 Exponent is 5. 


ADD AC1, X(7) 
BYTE (6) 8, 8, 7 


DEFINE MAC (A,B,C) 


Character 


<> 


Meaning 
Angle brackets. In an expression, enclose 


a numeric quantity. 


In conditional assembly statements, 
contain a single argument, and the 
conditional coding. 


In REPEAT statements, contain coding 
to be repeated. 


In macros, enclose the macro definition. 


Square brackets. Delimits literals. 


In OPDEF statement, contain new 
operator. 


Equal sign, direct assignment. 


Quotation marks enclose 7-bit ASCII 
text, from one to five characters. 


Number sign. Defines a symbol used as a 
tag. Variable. 


Apostrophe or single quote. Catenation 
character used only within macro 
definitions. 


Reverse slash. If used as the first char- 
acter in a macro call, the value of the 
following symbol is converted to an ASCII 
symbol in the current radix. 


Left arrow. Line continuation. 
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Example 


<A-B+500/C > 


IF1 <MOVE ACO, TAX> 


REPEAT 3, <SUB 17, TAG> 


DEFINE PUNCH 
<DATAO PTP, PUNBUF (4) > 


ADD 5, [MOVEI 3, TAX] 
OPDEF CAL [MOVE] 


SYM=6 
SYM=A+B* D 


" ABCDE" 
ADD 3,TAG# 


DEFINE MAC (A,B,C); 
< JUMP'A,B,C> 


MAC \A if A=500, this gen- 
erates three 7~bit ASCII 


characters. 


| FORTRAN IV COMPILER (F40) 
FUNCTION To compile source programs coded in FORTRAN IV 


programming language and produce machine language 
programs which are compatible with the Linking 
Loader and the Dynamic Debugging Technique pro- 
gram. 

e One-pass compiler 

¢ Accepts input from any input device 


¢ Includes features far in advance of ASA 


FORTRAN X3.9, 1966, requirements 


ENVIRONMENT 


FORTRAN IV = (9K permits 4 continuation lines; 10K or 
more permits 19 continuation lines) 


FORTRAN IV Subset - 5.5K (4 continuation lines only) 


Additional Core Requests additional core from the Monitor when needed. 


Equipment Required 







Minimum Core 










One input device (source program input). 





Two output devices (if both machine language output and 
a listing are desired). 
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INITIALIZATION 


-‘R F40 core J Loads the FORTRAN IV Compiler into core. 
. The FORTRAN IV Compiler is ready to accept a 
command. 
COMMANDS 
General Command Format 
objprog-dev: filename. ext, list-dev: filename .ext<— source-dev:filename.ext,........ source-n 
objprog-dev: The device on which the machine language coding is 
to be written. Only one such file is produced. 
MTAn: (magnetic tape) 
DTAn: (DECtape) 
DSK: (disk) 
PTP: (paper tape punch) 
deg. The device on which the compilation listing is to be 


source-dev: 





written. Only one such file is produced. 


MTAn: iaanetie tape) 
DTAn: (DECtape) 

LPT: (line printer) 
DSK: — (disk) 

TTY: (Teletype) 


The device(s) from which the source program(s) input 
to compilation is to be read. 


MTAn: (magnetic tape) 
DTAn: (DECtape) 

TTY: (Teletype) 

CDR: (card reader) 

PTR: (paper tape reader) 


Note: Each source file may contain any number of source programs and need not contain an integral 
number of source programs as END OF FILE is ignored. However, statements may not be split between 


files. 


2 ® e e e ° e e e e 
If this device is omitted, the last device named previous to it in the command string is assumed. 
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If more than one file is to be compiled from a mag- 
netic tape, card reader, or paper tape reader, dev: 
is foliowed by a comma for each file beyond the first. 


If more than one file is to be compiled from DSK: or 
DTAn:, subsequent filename.ext's after the first are 
delimited by commas; dev: need not be repeated. 


Input via the Teletype is terminated by typingthe ——, 


END statement followed by a carriage return. 


vets ; oF 
filename.ext (DSK: and DTAn: only) — The filename and filename extension of the object IMY 
program file, the listing file, and the source file(s). 
If .ext is omitted, .REL is assumed for the object file, 
.LST ts assumed for the listing file, and .F4 is as- 
sumed for the source file. 


_ The object program and listing devices are separated 


from the source device(s) by a left arrow. 


Disk File Command Format 
DSK:filename.ext[ proj, prog] 


[ proj, prog] The project-programmer number assigned to the disk 
area to be searched for the source File(s)or in which 
the destination file is to be written if other than the 
user's project-programmer number. 


The standard protection! is assigned to any disk file 
specified as output. 


Notes 


If object coding output is not desired (as in the case where a program is being scanned for source language 
errors), objprog-dev: is omitted. 


If a compilation listing is not desired, list-dev: is omitted. 


1 e e ® ° és 
Standard protection (055) designates that the owner is permitted to read or write, or change the protec- 
tion of, the file while others are permitted only to read the file. 
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EXAMPLES 


-R F40Q Compile one source file from the Teletype; write the 
bject code on the disk and assign the filename.ext 
*DSK:OBJP :—TTY: ~ : iene 
JPRO, LPT TTY: J OBJPRO.REL; write the compilation listing on the 
line printer. 


—>p| COMMON A,B,C,Dg Note | 
—>| DOUBLE PRECISION A,B,C,Dg 
—ATYPE 10g 
-ATYPE 20,A,B,C,D2 
'—DICALL RESID (1,1, 'P2222')} 
10 1 FORMAT ('--PHASET, MAIN--'/) } 
20 —e FORMAT (1HO0,D/) J 
—AENDg 
9Zo 
MAIN. ERRORS DETECTED: 0 


TOTAL ERRORS DETECTED: 0 
9K CORE USED 


“DTA3:TSTA, <— CDR:,,_ Compile three source program files from the card 
MAIN. ERRORS DETECTED: 0 reader; write the object code on DTAS3 and call the 


SUB1 ERRORS DETECTED: 0 file TSTA.REL; produce no compilation listing. 
SUB2 ERRORS DETECTED: 0 


Typein of source coding 





NOTE: This is not batch compilation. There may be 


TOTAL ERRORS DETECTED: 0 many source programs but only one object 
9K CORE USED code file is produced. Assume there js one 
7 main program and two subroutines, SUBI 
and SUB2, 
*4C A Return to the Monitor. 
-K JOB Kill the job, deassign all devices, and release core. 


NOTE 1: The use of TAB (—o ) effectively positions the a at column 7 of 





CTRL key at the same time the TAB key is depressed. 
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BATCH COMPILATION 


If several independent program files being compiled from the same input device require in- 


dependent listings on the same device, and require their (independent) machine language output on the 


same device, the length of the command strings required for each compilation can be shortened by as- 


signing the three common devices before running the compiler. The command strings will then consist 


only of the filenames of the source program files. As in the preceding section, each source file may 


contain several source programs but each file will be assumed to contain an integral number of programs. 


Example 


The files TESTA, TESTB, TESTC, and TESTD, all of which reside on DTAI are to be compiled. 


File TESTA contains two source programs. The object coding for each file is to be written on DTA2 and 


assigned the filenames of TESTA.REL, TESTB.REL, TESTC.REL, and TESTD.REL, respectively. 


.AS DTAI SRC g 
DEVICE DTAI ASSIGNED 


AS DTA2 BIN 2 


DEVICE DTA2 ASSIGNED 3 


.AS LPT LST Q 


DEVICE LPT ASSIGNED 2 


F40 J 


*TESTA, TESTB, TESTC, TESTD pf 
MAIN. ERRORS DETECTED: 0 
SUBA ERRORS DETECTED: 0 
SUBB ERRORS DETECTED: 0 
SUBC ERRORS DETECTED: 0 
SUBD ERRORS DETECTED: 0 


TOTAL ERRORS DETECTED: 0 
9K CORE USED 


*9Cy 
.KIOB gd 


| 


Assign DTAI as the common source device. 


Assign DTA2 as the common binary coding output 
device, 


Assign the line printer as the common listing output 
device. | | 


No devices need be specified in the command; the 
devices assigned are assumed. 


The object code from the two source programs in file 
TESTA will be written as file TESTA.REL on DTAZ | 
and so on for the other source files. ‘Assume TESTA 

contains a main program and subroutine SUBA, 


TESTB, TESTC, TESTD each contain one subroutine. 


Return to the Monitor (or, if desired, more filenames 
could be specified for another compilation). 


File TESTA.F4, TESTB.F4, etc., are assumed as the filenames and Scans of the source files; if 


TESTA.F4 cannot be found, filename TESTA js searched for (same for TESTB, TESTC, TESTD). 
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SWITCHES 


Switches are used to specify such options as: 
1. Magnetic tape control, 
2. Device directory manipulation, and 


3. Types of listings and message typeouts. 


All switches are either preceded by a slash or enclosed in parentheses. Switches C, E, Mand N are 
complementary. | 


Table FORTRAN-1 FORTRAN Switch Options 
Advance magnetic tape reel by one file. 








Backspace maanetic tone reel by one file. 


Generate a CREF-type cross-reference listing. 


Complement: Do not produce cross-reference information (standard procedure). 





Print an octal listing of the binary program produced by the compiler in addition to the 






symbolic listing output. 






Complement: Do not produce octal listing (standard procedure). 


Eliminate the macro coding from the output listing. 


Complement: Include macro coding in the output listing (standard procedure). 


Suppress output of error messages on the Teletype. 


Complement: Output error messages on TTY (standard procedure). 


If the compiler is running on the PDP-10, produce code for execution on the PDP-6 and 
vice~versa. 


A! 

C2 

52 

m2 

NZ 
Skip to the logical end of the magnetic tape reel. 
Rewind the magnetic tape reel. 
Zero the DECtape directory. 


Must immediately follow the device name or filename.ext to which it applies. 






2. Standard listing procedures are - list error messages on the TTY and the source program with 
macro coding on the listing device. f done unless a switch is used to override the 
standard listing. If the switch ig¢omplementary,}a second occurrence of it in a command 
string means revert to standard lisths esas described for the complement of the 

particular switch. A third occurrence of a switchactsas the first, and so on. 
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EXAMPLES 


.R F4O 2 
*DTA2:/ZOBJTST, LPT: — DSK:/EFORTAA| 12, 20] 2 


20 FORMMAT (1HO,D/) 3 
1) SYNTAX 3 


MAIN. ERRORS DETECTED: 1 


? TOTAL ERRORS DETECTED: | 
9K CORE USED 


*DTA3:JOBI, DSK:JOBIS— MTAI:/W,, g 
SUBI ERRORS DETECTED: 0 
SUB2 ERRORS DETECTED: 0 
SUB3 ERRORS DETECTED: 0 


TOTAL ERRORS DETECTED: 0 
9K CORE USED 


*9Co 


-KJOB 2 
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Zero the directory on DTA2 and create 
a file called OBJTST.REL as the binary 
object program file; compile the source 
file, FORTAA, located in area 12,20 
of the disk; produce a binary program 
listing (with octal code} as well as the 
regular source listing on the line printers. 
Assume FORTAA contains one main pro~ 
gram. 


A syntax error has been detected in the 
source language. Such typeouts can be 
suppressed by use of the /N switch. 


Create a new file called JOBI.REL on 
DTA3 as the binary object program file; 
create a file called JOBI.LST on the 
disk as the listing file; rewind MTAI, 
and compile the first three program files. 
Assume each contains one subroutine, 


SUBI,SUB2, SUBS; 
Return to the Monitor. 


Kill the job, deassign all devices, and 
release core. 


DIAGNOSTIC MESSAGES 


After each source program is compiled the message 
" pbrogram=name" ERRORS DETECTED: n 
is printed where | 
"program=-name" is 1) MAIN. for a main program 
2) DAT. for a BLOCK DATA subroutine 
3) Subroutine-name for a subroutine 
and after all the files specified in the command string have been compiled, the messages 
TOTAL ERRORS DETECTED: m 
nk CORE USED 
are printed, where m is the total number of errors detected and is preceded by "?" if m>0O, and n is 


the number of 1K blocks required to compile the programs. 


Table FORTRAN-2 FORTRAN Diagnostic Messages 


? BINARY OUTPUT ERROR dev:filename.ext An output error has occurred on the device spec- 
ified for the binary program output. 


?CANNOT FIND dev: filename. ext Filename.ext cannot be found on this device. 
?INPUT DATA ERROR dev:filename.ext A read error has occurred on the source device. 
?x IS A BAD SWITCH The specified switch is not recognizable. 


?x IS AN ILLEGAL CHARACTER A character in a command string typein is not 
recognizable (e.g., FORM-FEED). 

? dev: IS NOT AVAILABLE Either the device does not exist or it has been 
assigned to another job. 


?LISTING OUTPUT ERROR dev:filename. ext An output error has occurred on the device spec- 
ified for the binary program output. 


?NO ROOM FOR dev:filename. ext The directory on dev: DTAn is full and cannot ac- 
cept filename.ext as a new file, or a protection 
failure occurred for a DSK output file. 


2SYNTAX ERROR IN COMMAND STRING A syntax error has been detected in a command 

string typein (e.g., the <— has been omitted). 
INSUFFICIENT CORE - COMPILATION The compiler has insufficient table space to com- 
TERMINATED pile the program. 
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SMALL FORTRAN IV COMPILER 





The instructions below apply to the small FORTRAN IV (F40S) Compiler, which handles a subset of the 
standard FORTRAN IV Compiler (F40). 


INITIALIZATION 





Logical Assignments (see "Batch Compilation") 


eed ok A ae iP ESB TD AD yee gece : sas dace 
wR F40S Loads the smali FORTRAN IV Compiler Into core. 
* Vine Cor reyes yt yr ge FE ates de gm lal tavue mt alatectccle a 
PPO WOMTDEICPr ts FoOgOy 1O GCcepr a commana, 


COMMANDS 





1. Logical assignments must be made as shown for batch compilation (page FORTRAN-S). 


2. The command string can contain many source files but each source file is assumed to contain only 
one source program. Every source file on a directory device must have the extension ".F4" as this 
is assumed by the compiler. The command string, then, consists of filenames only. 


3. One binary output file and one listing file are produced if logical assignments have been made for 
them. 


4, If no listing device is specified, a source code error produces '"?E" on the user's Teletype. Com- 
pilation of that file is terminated. 


5. No switches are allowed. 


Example: 

AS DTA2 SRC 9 Assign DTA2 as the source device. 

DEVICE DTA2 ASSIGNED” 

AS DTA3 BIN g Assign DTAS as the binary output device. 

DEVICE DTA3 ASSIGNED g 

.R F4OS of Run the small compiler 

*FILA, FILBa Compile file FILA. F4 and FILB.F4. the object code 
for FILA.F4 will be written as file FILA.REL (and 
FILB.F4 as FILB.REL) on DTAS. 

*#C I Return to Monitor (or, if desired, more files can be 


* 


D 


5 #% 
cOMmpHed). 
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| LINKING LOADER (LOADER) 
FUNCTION To load and link relocatable binary (.REL) programs 


generated by Macro-10 or FORTRAN IV preparatory 
to execution. Generates a symbol table in core for 
execution under the Dynamic Debugging Technique 


program. 


® Provides automatic loading and relocation of 
Macro- and FORTRAN-generated binary programs 


@ Produces an optional storage map 





@ Storage used by the Linking Loader is recoverable 
after loading 


@ Performs loading and library searching regardless 
of the input medium 


ENVIRONMENT 


x 
Additional Core Automatically requests additional core from the Monitor as required. 





Equipment User Teletype for control; one or more input devices for binary pro- 
Required grams to be loaded; output device for loader map (optional); one 
systems device containing library files (optional). 
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INITIALIZATION 


.R LOADER core ,) 


COMMANDS 


General Command Format 


| 


Loads the Linking Loader into core. Core 
allocated equals 2K plus core required 
by binary programs; "core" is optimal. 


Indicates that the program is ready to 
receive a command, 


list-dev: filename .extq—— source-dev1:filename.ext,dev2:....source-n(ALTMODE 
list-dev: The device on which any storage maps or undefined 


source-dev: _ 


filename.ext (DSK: and DTAn: only) 


globals are to be written. 


LPT: (line printer) 
TTY: (Teletype) 
DTAn: (DECtape) 

DSK: (disk) 

MTAn: (magnetic tape) 


If the Teletype is to be assumed as the output 
device, omit | 


list -dev: filename .exta— 


The device(s) from which the binary relocatable 


programs are to be loaded. 


DSK: (disk) 

DTAn:  (DECtape) 

MTAn: (magnetic tape) 
PTR: (paper tape reader) 


If more than one file is to be loaded from a mag- 
netic tape, card reader, or paper tape reader, 

dev: is followed by a comma (or the device name 
or : can be repeated) for each file after the first. 


The filename .ext of each relocatable binary file to 
be loaded. If .ext is omitted, if is assumed fo be 
»REL. If a search for filename.REL is unsuccessful, 
a second search for the same filename with the nuil 
extension is performed. 


The filename .ext of the output listing file. If .ext 
is omitted, . MAP is used. 
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Notes 
bes 


2. 


<jp— The storage map device is separated from fhe source 
device(s) by the left arrow symbol. 


Each time RETURN () ) is typed, loading is performed for all files listed on that line. 


Each time ALTMODE is typed, all remaining loading, library searches, and output operations are 
completed, and an exit is made to the monitor. 


The source device, once stated, continues as the source device until a new source device or 
destination device is specified, or until ALTMODE is typed. 


Files are loaded in the order they appear in the command string. The file requiring the largest 
COMMON area must be specified first in any loading operation. 


When loading is terminated (by ALTMODE or switches /C, /G, or /R), the following steps are 


executed. 


a. 


A FORTRAN library search is performed if any undefined globals remain (unless prevented by 
the /P switch). 


If undefined globals still remain, they are listed on the Teletype or other specified listing 
device. 


The number of multiply defined globals (if any) and the number of undefined globals (if any) 
are printed on both the Teletype and on the specified listing device (if given). 


A Chain file, if requested, is written. 
The loaded program is relocated down to the actual locations into which it is to be loaded. 


The message 


LOADER 
EXIT 
OC 


is printed on the Teletype. 


Save and Execute Commands 


After loading is completed, to write the loaded program onto an output device so that it can be exe- 
cuted at some future date without rerunning Linking Loader: 


LOADER Q Loading is completed. 


EXIT) 


gC 


Automatic exit to the Monitor. 
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. SAVE dev: filename.ext core 


JOB SAVED 
$C) 


. START) 


EXIT J 
7c) 
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Write out the user's area of core onto 
the specified output device and, if 
the device is DTAn: or DSK: , assign 
it the specified filename.ext. If .ext 
is omitted, .SAV is assumed. 


The value for core may be given when 
the user wishes to run the program in 
more core than it will be saved in: this 
might be done to gain more space for 
dynamic allocation of buffers. 


Save operation completed. Core is 
unchanged and still contains loaded 
program. Automatic return is made 
to the Monitor. 


Start execution of loaded program. 
Return is made to user's level. 


User's program execution Is completed. 
Automatic return is made to the Moni- 
tor. 


EXAMPLES 


-R LOADER 5, 


“DSK:MARKI ,MARK3,DTA3:SUBRTE 2 
*CALC , PTR: Q@LTMODB) 2 


LOADER ,) 
EXIT 

7c 

‘SAVE DSK MARKET 


JOB SAVED, 
$C p 
‘START, 
EXIT 

7c) 
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Load Linking Loader and assign it 5K 
of core. 


Load and link the .REL files MARK] 
and MARKS from the disk, .REL files 
SUBRTE and CALC from DTAS, and 
one .REL file from the paper tape 
reader. 


Link-loading is completed; and auto- 


matic return is made to the Monitor. 


Write out the user's program as an 
executable program on the disk and 
call the file MARKET.DMP. Core as- 


signed to the user remains unchanged. 


NOTE: Saving a job is optional. 


Save process is completed; an auto~ 
matic return is made to the Monitor. 


Begin execution of job. 


Program execution is completed; auto- 
matic return is made to the Monitor. 


Switches are used to: 
1. Specify the types of symbols to be loaded or listed, 
. Set the library search mode, 


Load the Dynamic Debugging Technique (DDT) program, and 


k, WwW NY 


Clear and restart Linking Loader. 


All switches are either preceded by a slash (/) or enclosed in parentheses. 


Table LOADER-1 ~— Linking Loader Switch Options 





nnnnnC Create Chain file; use first block data for program break; 


nannn (if nonzero) is starting address. Terminate Linking 


List all global symbols in storage map regardless of program 
length, 
nad Loader. a 
Load DDT; enter “load with symbols: 
mode (S); turn off library search 
mode (N). 
Terminates specification. 


A ®) 
E 
| pe 
nnnnnG Perform an automatic search of LIB40 if any undefined globals 
remain (unless the /P switch is used); list any still-undefined 
globals; set the starting address of the program as nnnnn; exit 
to the Monitor. Use ALTMODE, instead, if starting address to 
pe used is the one originally specified. 
| 8 


Upon termination of loading, control will be transferred to 
user's program starting address (starting address of last program 
loaded). 


gs 


Perform a library search of LIB40; exit from "load with symbols 
mode. 





Terminates specification. 





Set the loader to ignore the starting addresses in binary input. 


Set the loader to accept the starting address of this binary input 


program. 


Enter the library search mode. 


OC indicates those switches set when loader is in its initial state. 
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Table LOADER~1 (Cont) Linking Loader Switch Options 





| Print the storage map and undefined globals. Terminate speci- 
| fication. 


Turn off the library search mode. Ee 
Load beginning at numeric argument (octal) if nonzero. Be en 


Prevent an automatic library search. 
ret Load with local symbols. 
testing. 
«&) Suppress listing of global symbols for zero-length programs. 
restore the Teletype; restart loading. Terminates line. 


Allow an automatic library search. Turn off the “load with 
Loads SYS:DDT.REL; turns on “load with local symbols (S) switch; es 
U List undefined global symbols on the output list device. 
Terminates specification. 
Qo 
Rewind magnetic tape before use. ‘i iii 





Create Chain file; use first FORTRAN IV program break; nnnnn 
(if nonzero) is starting address. Terminate Linking Loader. 















local symbols" switch. 
upon termination of loading transfers control to DDT for program 
Clear user's core area; reset the loader to its initial state; 






indicates those switches set when loader is in its initial state. 


NoTE © 


The effect of a switch on adjacently named files in the command string depends upon whether 


the switch is a status switch or an action switch. 


Status Switches (A, I, J, L, N, O, P, Q, S, W, X) set the loader to a particular status and have an 
effect on the file in whose specification it appears and on any subsequently name files 
in the command string (unless the switch is reset). A file specification is terminated 
and processed whenever a comma, or a colon (if the previous delimiter was a colon), 


a RETURN, or ALTMODE is encountered. 


*DTAS5:RESID/S ,/M Local symbols are loaded for this and any following 
files. A storage map is printed for this file. 
*DTAS:RESID ,/M/S A storage map is printed for this file; however, 


local symbols are not loaded for this file since the 
/S switch appears outside the file specification 
(which is terminated by the comma). Local symbols 
are loaded for any following files. 
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*DTAS:RESID ,/S Local symbols are not loaded for this file since the 
/S switch appears outside the file specification 
(which is terminated by the comma). 


Action Switches (C,D,E,F,G,M,R,1,U, Y) request an immediate or file-independent action to be 
performed by the Loader and are not directly related to any specific file specification(s). 


Chain Feature 


The Chain feature is used to segment FORTRAN programs which are. too large to be loaded into core as 
one unit. When switch /C or /R is specified, loading is terminated and a file acceptable to the Chain 
program is written. 

Examples: *DSK:CHNPRG #—/R or *DTAI:SEGF4 #—/C 

If .ext is omitted for the output Chain filename, .CHN is used. 


The Chain file contains: 
1. The contents to be loaded into JOBDDT, JOBSA, JOBFF, and JOBSYM. 


2. The data, beginning from the Chain address through the top of the core area used in loading. 


The Chain address is set from JOBCHN as loaded; switch /C specifies the right half and switch /R 
specifies the left half. Location JOBCHN is loaded as follows: (1) the right half contains the program 
break of the first FORTRAN IV BLOC K DATA program; (2) the left half contains the program break of the 
first FORTRAN IV program. Ifswitch/C or /R contains anonzero numeric argument, this becomes the 
starting address of the loaded program. After the Chain file has been written correctly, the messages 


below are output to the Teletype. 


CHAIN ) 
EXIT, 
aC Q 
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-R LOADER 6, 


“DTAS:RESID , SUBI ,SUB2, DTA3:COMPLX ,) 


*/F 


*/UQ 
2000001 UNDEFINED GLOBALS ) 
? SUB4A 000153) _ 


*DTA5:SUB4,) 


*/U) 


*LPT:/M<— (@LIMODD),) 
LOADER J) 

EXIT 

C2 

-KJOB, 
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Run Linking Loader and assign it 6K 
of core. 


Load and link binary program files 

RESID.REL, SUB].REL, and SUB2.REL 
from DTAS5, and the file COMPLX.REL, 
DTAS. 


Carriage return initiates loading. 


Force a premature search of LIB40 to 
resolve any undefined globals up to 


< ens porar. 


List on the Teletype (since no output 

device was specified in the first com~ 
mand line) all globais which are still 

undefined. 


Undefined global and location con- 
taining instruction which calls it are 
listed. 


Knowing that the undefined global is 
in the binary program file SUB4, the 
user requests that it be loaded also. 


Check if undefined global has now 
been resolved. 


All globals are defined; print storage 
map on the line printer and exit to 
the Monitor. 


Kill the job, deassign all devices, 
and release core. 


DIAGNOSTIC MESSAGES 


Table LOADER-2 Linking Loader Diagnostic Messages 





Message eo 7 Meaning | 













The filename.ext specified is not in the file direc- 
tory. If no .ext is specified for a file, the file is 
first searched for with the name filename.REL, and 
if not found, is then searched for under the null 
filename extension. 


2? CANNOT FIND filename.ext 


? CHAIN DEV ERROR 
2x CHAR. ERROR IN LOADER COMMAND 
2 DIR. FULL 


EXIT 


PILL. COMMON filename. ext 









A device error has occurred while writing the 
Chain file. Chain file is terminated. 









An illegal character was entered in a command 
string. 
















The file directory of the specified list device is full 
and cannot contain an additional file, or a null file 
name was specified. 





If this message appears at the beginning of the 
run, either insufficient core has been assigned for 
loading or no console is attached to the job. 
EXIT normally is typed at the end of the loading 
process (after ALTMODE or /G) before exiting to 


the monitor. 


A file other than the first contains a program which 
has attempted to expand the already established 
COMMON area. This program must be loaded 
first. 













PILL. FORMAT filename.ext 


INPUT ERROR filename. ext 


?symbol ignored-value old-value 


MUL.DEF.GLOBAL filename.ext 


The input source file is in proper checksummed 
binary format, but not in proper link format. 







A read error has occurred on an input source de- 
vice. Use of that device is terminated. 









A global symbol definition having a value different 
from that of a previous definition of the same sym- 
bol has been encountered. The new value is 
ignored and the symbol appears in the symbol table 
only once. 


? NO CHAIN DEVICE No device has been specified for the Chain file. 
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Pdge LOADER-6 (Switch E, "Mebning" Column) Add:\ "Equivalent to #phing START after exit 
| from Loader{ " ! 

Pag LOADER-7, \ (Switch Ny "Complement Switéh" Column) Add: #L" 

a (Switch T}, "Mearking" Colunin) Add: "Bquivalenj to typidg /D in command 


string and, then, after exif from Loader, typing PDT." 


Page LO -8 (Mine 14) Change "I. The contents to be loaded into JOBDDT>..."to "1. 


The contents to be loaded into JOB41, JOBDDT, ..." 


Page LOADER-9 (Bottom of page) Insert: 
Use of /E Switch: 


«R LOADER ¢ 
*DSK:PROG 1, PROG2/E 
LOADER CORE 7 ¢ (Typeout from Loader) 
...program execution occurs here.... 
| EXIT ¢ 
IC¢ 





(Following "? DIR. FULL") Insert: 


ERROR WHILE READING Loader was unable to read part of a command 
COMMAND FILE 


string stored on the disk. Program was partially 


loaded. 


EXECUTION DELETED Loader has loaded a program because the user 
gave an EXECUTE or DEBUG command, however, 
the program, or DDT, was not started because 


there were compilation errors in at least one 


.REL file. 
(Following "? symbol ignored value....") Insert: 


MORE CORE NEEDED Loader requested additional core from Monitor, 


but none was available. 


Page LOADER-10 (prior to last Li Table LOADER-2) Insert: 





Nel , q f OCTOBER-DECEMBER, 1968 
oo 5 
Lorde 


J) 


ra 


~ Page LIBXO-1 | Change all references from "Scientific Library" to "Science Library" Change ( 
| all references from "subroutines" to "subprograms Wf 
f 
Page FUDGE-5 (line 4 and 5, command column) Change to: vi 
7 *DSK:LIB4BB-DTA2:LIB4AA<EXP.3>, DTAI:F1 ¢ 
<EXP.3A,EXP.3B>,DTA3:EXPNT (R) (ALTMODE) ¢ 


Page DDT-T (lige 12) Change "test" to "text" 


Page DDT-2 (lines 6, 7, 8) Asterisks should be blge. Change "*DTA5:TEST" to '*dev: 


filename. ext" 


NOTE: TheYfollowing changes reflect DDT.V11 and later. 


Page DDT-8 ("Type-Out Mddes" - lines 9 


(4002)4005 
(X+1)X+4 


dnd 10 under "Sample Output(s)") - Change 


4002, ,4005 
X+1,,X+4 







lords" line 1 under "Sample Output(s) ") 
(254020) DDTEND/\ to 254020, ,DDTEND 

(line 3 under "Samplé Output (s) ") Change 
254020003454 to 254020, ,3454 


Page DDT-9 ("Examining Storage 


Page DDT-10 ("Typing In" ns 4 and 5) Change 
"To type in half words, enclose.\..." (402)403 
a Fi to 
"To type-in half words, separate the \eft and right halves with two commas. " 


402, ,403 


Page DDT-11 | ("Arithmetic Operators Permitted in Forming Expressions") 


Change "Two's complement addition" to "TWo's complement integer addition" 


/ Change "Two's complement subtraction" to "To's complement integer subtraction" 


¥ e e * * 
/ Delete the entire line on "Hierarchial parentheses" 


/ (Field Delimiters in Symbolic Typeins") Insert: 
j To delimit two half words, type left, ,right 
Page DDT=12 / ("Breakpoints (Cont.)") Change &. 
| adr(x)$nB Z+6(AC3)$5B x, ,adr$nB AC3, ,Z+6$5B 
adr(x)$B ABLE(AC4)$B ms x, ,adr$B AC4, ,ABLE$B 
| adr(x)$$nB Z+6(AC3)$$5B x, ,adr$$nB AC3, ,Z+6$$5B 
adr(x)$$B ABLE(AC4)$$B | x, ,adr$$B AC4, ,ABLE$$B 
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Table LOADER-2 (Cont) Linking Loader Diagnostic Messages 


?x SWITCH ERROR IN LOADER COMMAND An improper switch designation has been entered 


in @ command string. 


2x SYNTAX ERROR IN LOADER COMMAND A syntax error has been encountered in a command 
string. 

?dev: UNAVAILABLE Either the device does not exist or it is assigned 
to another job. 


?UNCHAINABLE AS LOADED The Chain address (the half of JOBCHN selected 
by /C or /R) is zero. 
?nnnnnn UNDEFINED GLOBALS nnnnnn undefined globals were found. 


? SYMBOL TABLE OVERLAP file.ext nnnnnn additional words (octal) are required to 
?nnnnnn WORDS OF OVERLAP file.ext load everything requested in the last command 
| string line. 
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FORTRAN LIBRARY 
@ FORTRAN OPERATING SYSTEM (FORSE.) 
@ SCIENTIFIC SUBROUTINES 


FUNCTION The FORTRAN Library (LIB40) contains the FORTRAN 


Operating System (FORSE.) and its subroutines, as 
ONCE 
well as the CLs Subroutine Library. Some of 


these library routines are always required by 






FORTRAN-compiled programs at run time. 


The FORTRAN Operating System performs two major 
functions: (1) all I/O operations and format con- 
versions, and (2) error checking and output of error 


messages on the Teletype. 


COMPILATION TIME 


At compilation time, the FORTRAN compiler generates user UUO's in the range of 00 through 37g to 
communicate the necessary I/O requests to FORSE. These UUO's are interpreted at run time by FORSE., 
which in turn executes Monitor UUO's (40 through 77g) to perform the actual I/O operations called for. 


LOADING TIME 


The loading of the appropriate subroutines from the FORTRAN Library is performed for each FORTRAN- 
compiled program by the Linking Loader. When loading is terminated, an automatic search of the 
FORTRAN Library file (LIB40) is performed for any programs referred to by the FORTRAN-compiled pro- 
gram but not explicitly loaded previously by the user. As a result of this search, FORSE., its related 
subroutines, and any required Setenttfe Library subroutines are loaded. 


A CULE 


LIB40-1 


User's relative 


address ] 40, 


FORTRAN Main Program 
(User's Coding) 


LIB40 Routines: 
~ FORTRAN Operating System (FORSE.) 


~ Scientific Library, etc. 
I/O Buffers 


Unused Area 


(May be used for I/O buffers 


if there are many devices) 


Symbol Table 





Last location 
of user area 


Figure LIB40-1 Core Storage Map of DDT, 
FORTRAN Main Program, and LIB40 


LIB40-2 


. DIAGNOSTIC MESSAGES 
Table LIB40-1 FORTRAN Operating System Diagnostic Messages 


? DEVICE dev: NOT AVAILABLE | FORSE. tried to initialize a device which either 


does not exist or has been assigned to another job. 


? DEVICE NUMBER n IS ILLEGAL. A nonexistent device number was selected. 


? DOUBLE PRECISION OVER OR UNDERFLOW An overflow or underflow error occurred while 
adding, subtracting, multiplying, or dividing two 





double-precision numbers. 





2? END OF FILE ON dev: A premature end of file has occurred on an input 
| device. 
2 END OF TAPE ON dev: The end of tape marker has been sensed during 
| input or output. | 
2 FILE NAME filename.ext NOT ON 
DEVICE dev: oe | | 


?P ILLEGAL CHARACTER, x, IN FORMAT 





Filename.ext cannot be found in the directory of 
the specified device. 









The illegal character x is not valid for a FORMAT 
statement. 


PILLEGAL CHARACTER, x, IN The illegal character, x, is not valid for this type 
INPUT STRING of input. | 





?PILLEGAL PHYSICAL RECORD COUNT FORSE. has encountered an inconsistency in the 
TAPE dev: physical record count on a magnetic tape. 
? ILLEGAL USER UUO uuu AT USER loc An illegal user UUO to FORSE. was encountered 
at location loc. 
2 INPUT DEVICE ERROR ON dev A data transmission error has been detected in the 
input from a device. 


f 


?MORE THAN 15 DEVICES REQUESTED Too many devices have been requested. 
? NAMELIST SYNTAX ERROR Improper mode of I/O (octal or Hollerith), in- 
correct variable name. 


? NO ROOM FOR FILE filename.ext There is no room for the file in the directory of 


? ILLEGAL MAGNETIC TAPE OPERATION, An attempt was made to skip a record after per- 
TAPE dev: forming output on a magnetic tape 


ON DEVICE dev: the named device. 
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Table LIB40~1 (cont.) FORTRAN Operating System Diagnostic Messages 


programname NOT LOADED A dummy routine was loaded instead of the real 
one. Generally, this error occurs when a loaded 
program is patched to include a call to a library 
program which was not called by the original pro- 
gram at load time. 


2? OUTPUT DEVICE ERROR ON dev: A data transmission error has been detected during 
output to a device. 


? PARITY ERROR ON dev: A parity error has been detected. 


? REREAD EXECUTED BEFORE FIRST READ A reread was attempted before initializing the 
first input device. 


? TAPE RECORD TOO SHORT ON UNIT n The data list is too long on a binary tape read 


operation. 


?dev: WRITE PROTECTED The device is write locked. | 


NOTE: With the exception of the messages "DOUBLE PRECISION OVE ‘Of UNDERFLOW" and 
"ILLEGAL USER UUO uuu AT USER loc," all messages are followed by a second message 


2? LAST FORTRAN I/O AT USER LOC adr 
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FUNCTION 


JOBUUO 
JOB4I 


JOBREL 


JOBDDT 


JOBSYM 


JOB DATA AREA (JOBDAT) 


This area provides storage for items of interest to both 
the Monitor and the user. The job data area is auto- 
matically allocated space just prior to the core area 
occupied by the program coding. The area occupies 


96, 0 (I 40.) locations. 


JOBDAT exists in binary form in the Systems Library 
for loading with user programs which refer to JOBDAT 
locations symbolically. JOBDAT is loaded auto- 
matically, if needed, during the Loader's library 


search. 


Table JOBDAT-1 Job Data Area Locations 


Relative 
Location(s) 


Octal 


Decimal 


Description 


User's location 40g. Used for processing user UUO's (001 through 
037). 


User's location 41g. Contains the beginning address of the user's 
programmed operator service routine. 


Left half: O 

Right half: The highest relative core location available to the user 
(i.e., the contents of the memory protection register when this 
user is running). | 


Contains the starting address of DDT. If contents are 0, DDT has 
not been loaded. 


Contains a pointer to the symbol table created by Linking Loader. 
Left half: Negative count of the length of the symbol table. 
Right half: Lowest register used. 

Left half: First free-location in user area (set by Loader). 

Right half: Starting address of the user's program. 

Left half: 0 


Right half: Address of the first free location following the user's 
program. Set to C(JOBSA), ,, by RESET UUO. 
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Table JOBDAT-1 (Cont) Job Data Area Locations 


Relative 
Location(s) Description 
Octal Decimal 


JOBREN | | Set by user and used by REENTER command as an alternate entry 
| | point. 


JOBAPR Left half: 0 


Right half: -Set by user program to trap address when user is en- 
abled to handle APR traps such as illegal memory, pushdown over- 


flow, arithmetic overflow, and clock. See CALL APRENB UUO. 


JOBCNI | Contains state of APR as stored by CONI APR when a user~enabled 
3 APR trap occurs. 


JOBTPC Monitor stores PC of next instruction to be executed when a user- 
enabled APR trap occurs. 


JOBOPC | The previous contents of the user's program counter are stored here 
by Monitor upon execution of a DDT, REENTER, START, or 
CSTART command. 


JOBCHN Left half: 0 


el a er 
Right half: Address of first locatten_after first FORTRAN IV Block 
Data. oS 


NOTE: ,Only those J@BDAT locations of significant importance to the user are given in this table. 
» JOBDAT lofgations not listed include those which are used by the Monito\ and those which 


¥ 


= unused at the present time. User programs should not refer to any lodations not listed 
a 
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| FILE UPDATE GENERATOR (FUDGE2) 
FUNCTION To update files containing one or more relocatable 


binary programs. 


@ Permits user to manipulate individual programs 
within program files 


ENVIRONMENT 
















Additional Core Dynamically allocates its buffers to utilize as much core as 
is made available. | 


| Equipment Two input devices, one for the master file and one for the 
Required | transaction file; one output device for the updated file. 

The input device(s) and output device can be the same de- 

vice (DSK:). The two input devices can be the same DECtape. 
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INITIALIZATION 


.R FUDGE2q) 


COMMANDS 


General Command Format 


Loads the File Update Generator 
program. 


FUDGE2 is ready to receive a 


command. 


new-dev: filename .ext<— master-dev: filename .ext< prognamel , progname2, . .prognamen>, 


transaction-dev:filename .ext<prognamea, prognameb, .. .prognamez > (commands) (ALTMODE 


new-dev: 


master-dev: 


transaction-dev: 


The destination device, on which the updated 
file is written. 


DTAn: (DEC tape) 

DSK: (disk) 

MTAn: — (magnetic tape) 
PLPe (paper tape punch) 


The device containing the file to be updated. 


DTAn: (DEC tape) 


DSK: (disk) 
MTAn: — (magnetic tape) 
PPR: (paper tape reader) 


NOTE: If more than one file is to be transferred 
from a magnetic tape or paper tape 
reader, dev: is followed by a colon (:) 
for each file after the first. 


The device containing the file of programs to be 
used in the updating process. 


DTAn: (DECtape) 


DSK: (disk) 
MTAn: (magnetic tape) 
PTR: (paper tape reader) 


NOTE: If more than one file is to be transferred 
from a magnetic tape or paper tape 
reader, dev: is followed by a colon (:) 
for each file after the first. 
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More than one transaction device, with its associated 
filenames and program names, can be specified in 
certain instances (see "Switches"). 


filename.ext (DSK: and DTAn: only) 


The filename.ext of the new, updated version of 
the program file. 


The filename.ext of the program file containing 
the programs to be deleted, replaced, or augmented. 


The filename.ext of the program file containing 
the programs to be used in performing additions or 
replacements to the master file 


If no .ext is given, .REL is assumed. 
<progname,..... >(DSK: and DTAn: only) 
Program names must be specified in the same 


relative order in which they appear in the file. 


Program names are grouped together within angle 
brackets< >and are separated by commas. 


If it is desired to append, replace, insert, or 
extract all programs within a file, only the 
filename.ext need be specified. 


Program names cannot be specified for the output 


file. 


<+— The new output file is separated from the master 
and transaction files by the left arrow symbol (<-———). 





Command Codes 
The function to be performed by FUDGE2 is selected by including one of the following command codes 


at the end of the command string. Command codes are enclosed within parentheses (or preceded by a 
slash) and one (and only one) must appear in every command string. 


Table FUDGE-1 FUDGE2 Command Codes 


A Append one or more programs from the transaction file(s) to the master file and write 


out the new file. The command string is as follows: 


new-file «— master-file, transaction-file,..... (A) @LTMODB) 
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Table FUDGE-1 (Cont) FUDGE2 Command Codes 


Delete one or more programs from the master file and write out the new file. The files 
(and programs) to be deleted are listed after master-dev:. The command string is as 
follows: 


new-file q— master-file<file(s) to be deleted>(D) (ALTMODE 


Extract the specified files. (and programs) from one or more input files and create a new 
output file. If program names are not specified for a file, the entire file is extracted. 
The command string is as follows: 


new-file +— masterfile<file(s) to be extracted>(E) (ALTMODE 


Insert programs from one or more transaction files onto the master file and write out the 
new file. The programs from the transaction file(s) are inserted immediately before the 
specified programs on the master file. The command string is as follows: 


new-file #— master-file<file(s)to be inserted before>, transaction-file(s) (1) ALTMODE 


List all relocatable programs within a file and print the listing on the output device, 
which must be either TTY: or LPT: The command string is as follows: 


listing-device #— file(L) @LTMODB 


Replace the named program(s) on the master file with the named program(s) from the 
transaction file and write out the new file. The command string is as follows: 


new-file ¢— master-file<file(s) to be replaced >, transaction-file<replacement file(s)> 


(R) @LTMODE 





NOTE: Only one operation can be specified per command string. Thus, to delete a file and replace 
some other one, two command strings are required. 
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Switches are used to manipulate file directories and to position magnetic tape. They are either preceded 
by a slash or enclosed in parentheses and can appear anywhere in the command string. 


Table FUDGE-2 FUDGE2 Switch Options 


Backspace magnetic tape one file. 


Aavance magnetic tape one file. 


Rewind magnetic tape. 


g 


f* x . ; al a tert / ¢ £ he me °. 4 Pa 4 é a ee r; ; 
Clear airectory or destination devices WW iAn: 
f 





.R FUDGE2) 
*DTA2:TESTA@— MTAI:(WK) ,MTA2: :(ZA)(QLTMOD R Clear the directory of DTA2; rewind 


TAT od ; bey cn Pere wig 

MTA! and advance the tape one file; 
sales 5. ay er ae i | 

append the first two program files 
Pune MAT AD: Gs. ah cand Etta an AATAT 
rrom MIAZ to the second Tile on MTA! 

ee Pee ree 7 eT Tae eee ab ae eee 
OMG Wits Our Tie TSesuiTeny Wie of 


FUDGE-6 


DIAGNOSTIC MESSAGES 


Table FUDGE-3 FUDGE2 Diagnostic Messages 


2CANNOT DO I/O AS REQUESTED Input cannot be performed on one of the devices 
specified for input (it is an output only device) or 
output cannot be performed on the device specified 








for output. 
2? DEVICE ERROR ON OUTPUT DEVICE A write error has occurred on the output file. 
? DIRECTORY FULL ON OUTPUT DEVICE No more files can be added to the file directory on 
the output device (the directory is full). 
2 ENTRY BLOCK TOO LARGE, The entry block of program xxxxxx is too large for 
PROGRAM xxxxxx the FUDGE2 entry table, which allows for 32 entry 


names. FUDGE2 can be reassembled with a larger 
table. 





2? FUDGE SYNTAX ERROR 






The command string is illegal (e.g., the left arrow 
was omitted, a program name was specified for the 
output file, or some meaningless command was 

entered). 


2x IS AN ILLEGAL CHARACTER An illegal character has been encountered in the 
command string. 

?x IS AN ILLEGAL SWITCH An illegal or otherwise meaningless switch has been 
encountered in the command string. 


?dev NOT AVAILABLE The device either does not exist or has been as- 


signed to another job. 






? NOT ENOUGH ARGUMENTS — An insufficient number of files of one type or an- 


other has been specified. 


? dev filename.ext progname NOT FOUND Either the filename.ext or the program name was 
not found on the device (or in the file) specified. 


If a program name is printed, this may indicate that 
the program names in the command string appear in 
a sequence different from their sequence within the 
file; thus, the program may actually exist in the 
named file but was missed because of the incorrectly 
entered sequence in the command string. 


2 PROGRAM ERROR WHILE RESETTING Either FUDGE2 cannot find the master device or 
MASTER DEVICE cannot find the program name on the master device. 
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Table FUDGE-3 (cont.) FUDGE2 Diagnostic Messages 


2?TOO MANY FILE NAMES OR | More than 40 program names or file names were 
PROGRAM NAMES given in a command string. Break the job into 


several segments and rerun. | 


2? TRANSMISSION ERROR ON | A transmission error has occurred while reading data 
INPUT DEVICE dev from device dev. 


2? UNEQUAL NUMBER OF MASTER | _ An unequal number of master and transaction pro- 
AND TRANSACTION PROGRAMS © grams (or files) has been specified with a Replace 


request. 
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| DYNAMIC DEBUGGING TECHNIQUE (DDT) 
FUNCTION To provide a powerful, easy-to-use on-line debug- 


ging system. 
® Monitors the status of a running program 


@ Enables the user to modify program instructions 
at any point during run time 


e User may stop program at predetermined points 
(break points) 


e Can be used to create and execute a program 


e Performs "effective address" searches to obtain 
all references to a given core location: 


@ Input/output can be in symbolic, numeric, and 
t modes 


ENVIRONMENT 





Monitor 







Additional Core ~ Not used. 


Equipment Required Only the equipment required by the program being 
debugged, plus a Teletype. 
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COMMONLY USED COMMANDS NOTE: In general, commands can be entered be- 


fore the program execution is started or 
during a breakpoint halt. 


To Set a Breakpoint 





Up to eight breakpoints can be set at any one time. 


adr$B 


adr$nB 


adr (loc)$nB 
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To Proceed From a Breakpoint Halt 


i next time the 


dre 


ion. 
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m execut 
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7 * 
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To Remove a Breakpoint 


Yee 


f xo2 
ae 
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TO 
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ROT 


ry 


O$nB 


re 
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To Use Symbols (Tags) 





progname$ 


To Assign a Symbol (Tag) to an Address 





oe 


adr/ contents symbol 


To Assign a Value to a Symbol 


sooo 
op see 


ae 


8 nd 
-, 





ds 


value<symbol 
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EXAMPLE 


-DDTy 


TEST2$: p 

LOOPS$IB¥ 

START$Gy 

$1B>>LOOP->| COUNT/—AI MOVE 1,CTR ,) 


$Py 


$1B>> LOOP-o| CTR/-o (garbage)-p] = 1734563210 


TST/-el ADD 4,@NUM(17)-of ADD 4,@NUM(16)(LINE FEED)) 


TST+1/—of JRST 4, TEMP 6} 
0$1B-l SUBRTESGQ 


EXIT, 


Tey 


Select the Symbol Table of the 
program named TESTZ2. 


- Set breakpoint #1 at the location 


LOOP: 


Start the program execution at sym- 


bolic location START. 


Breakpoint #1 has been encountered. 
User requests typeout of contents of 
location COUNT. User decides to 
proceed until breakpoint is reached 
again, 


Breakpoint #1 has again been encount- 
ered. User requests typeout of con- 
tents of location CTR. Since the 
contents of CTR as a symbolic instruct-_ 
ion are meaningless, the user types = to 
request retyping of contents in the cur- 
rent radix (octal). — 


User requests typeout of location TST 
and changes its contents. LINE-FEED 
typein causes typeout of address and 
contents of next sequential location. 


Remove breakpoint #1; resume ex- 
ecution at location SUBRTE. 


Program execution is finished; auto- 


matic return to the Monitor. 


| | 
The Teletype keys ALTMODE (ALT), PREFIX, or ESCAPE (ESC) are all equivalent to the $ in DDT 


commands (except when typing in text strings). 
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SUMMARY OF DDT COMMANDS 


Type-Out Modes 


To set the type-out mode to: Type this Sample Output (s) 
Symbolic instructions $S ADD 4, TAG+1 
ADD 4, 4002 
Numeric, in current radix $C 69. 
105 
Floating point $F 0.125E-3 
7-bit ASCII text $T PQRST 
SIXBIT text $6T TSRQPO 
RADIX50 $5T 4 DDTEND 
Halfwords, two addresses $H (4002) 4005 “bz, , Udo ‘7 
EY NE: M44 FY 
Bytes (of n bits each) $nO $80 could yield 


0,14, 237,123,0 


Address Modes 
To set the address mode for typeout of symbolic instructions and halfwords (see examples 
above) to | 
Relative to symbolic address $R TAG*+1 
Absolute numeric address | $A 4005 


Radix Change 
To change the radix of numeric typeouts to n (for n >2), type 


$nR $2R could yield 
11010110000001 000000000001 1100101100 


Permanent vs Temporary Modes 


To set a temporary type-out or address mode 

or a temporary radix as shown in the com- 

mands above, type $ $C 
$10R 


To instead set a permanent type-out or address 
mode or a permanent radix, in the commands 


above, substitute $$ $$C 
: $$10R 
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Permanent vs Temporary Modes (cont) 


To terminate temporary modes and revert to 
permanent modes, or re-enter DDT, type a 
carriage return. 


Initial permanent (and temporary) modes are 


Examining Storage Words 


To open and examine the contents of any 
address in current type-out mode 





To open a word, but inhibit the type out 
of contents 


To open and examine a word as a number 
in the current radix 


To open and examine a word as a symbolic 
instruction 


To retype the last quantity typed (particu- 
larly used after changing the current 
type-out mode) 


Examining A Related Storage Word 


One-Time 


To close the current open word (making any 
modification typed in) and to open the 
following related words, examining them 

in the current type~out mode: 


To examine adr +1 


To examine adr -1 


To examine the contents of the location 
specified by the address of the last 
quantity typed, and to set the location 
pointer to this address 


To examine the contents of address of last 
quantity typed, but not change the loca- 
tion pointer 


To close the currently open word, without 
opening a new word, and revert to per- 
manent type-out modes. 


Only Typeouts 


To repeat the last typeout as a number in 
the current radix 
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Sample Output(s) 


(254020)DDTEND 
250 20,, DDTEMD 


254020003454 
254 620, 06 3Y5Y. 


JRST @DDTEND 


#5 A999646E+1 I 
5%0 <L 


% (line feed) 


4 (or backspace, 
on the Teletype 
Model 37) 


—>l (TAB) 


\ (backslash) 


d (carriage return) 


One-Time Only Typeouts (cont) 


Symbols 


To repeat the last typeout as a symbolic 
instruction (the address part is determined 


by $A or $R) 


To type out, in the current type-out mode, 
the contents of the location specified by 
the address in the open instruction word, 
and to open that location, but not move 
the location pointer. 


To type out, as a number, the contents of the 
location specified by the open instruction 
word and to open that location, but not move 
the location pointer. 


To type out, as a symbolic instruction, the 
contents of the location specified by the 
open instruction word, and to open that 
word, but not move the location pointer. 


Current type-out modes do not affect typing 
in, instead 


To type in a symbolic instruction 

To type in half words, enclose the left : 
half in parentheses. 

To type in octal values 


To type in a fixed-point decimal integer 


To type in a floating-point number 


To type in up to five 7-bit PDP-10 ASCII 
characters, left justified, delimited by any 
printing character 


To type in one PDP-10 ASCII character, 
right justified 


To type in up to six SIXBIT characters, 
left justified, delimited by any printing 
character 


To type in one SIXBIT character, right 
justified | 


To permit reference to local symbols within 
a program titled "name" | | 


To insert or redefine a symbol in the symbol 
table and give it the value n 


DDT-10 


Type this 


ADD AC1, @DATE(17) 


(402)403 
1234 
99. 


101.11 
77 .OE+2 


" /ABC DE/ 


"A$ 


$"ABCDEFGA 


$"Q$ 


40S, 40 3 


(/is delimiter) 


($ must be ALTMODE) 


(A is delimiter) 


($ must be ALTMODE) 


Example 


MAIN.$: 


~1ASTABL3: 





Symbols (cont) Type This Example 


To insert or redefine a symbol in the symbol 
table, and give it a value equal to the 
location pointer (.) symbol: SYM: 


To delete a symbol from the symbol table symbol$$K LPCT$$K 


To kill a symbol for typeouts (but still permit 
it to be used for typing in) symbol $K TBIT$$K 


To perform $K on the last symbol typed out 
and then to retype the last quantity $D 


To declare a symbol whose value is to be 


defined later symbol# JRST AJAX# 
To type out a list of all undefined symbols 
(which were created by *) 

Special DDT Symbols 


To represent the address of the location 
pointer 


To represent the last quantity typed 
To represent the indirect address bit 
To represent the address of the search mask 


To represent the address of the saved flags, 
etc. 


To represent the pointers associated with the 


nth breakpoint 


Arithmetic Operators Permitted in Forming Expressions 


Two's complement, addition 
A, 

Two's complement,subt ction 

Integer multiplication - 


Integer division (remainder discarded) ' (apostrophe) 


Hierarchical parentheses (( )) A*((B+C)) 


Field Delimiters in Symbolic Typeins 


To delimit op-code name, type one or 
more spaces 


To delimit accumulator field 
To delimit index register 


To indicate indirect addressing 





DDT-11 


Breakpoints (cont) 


To set a specific breakpoint n_ (I1<n<8) 


To set the next unused breakpoint 


To set a breakpoint with automatic proceed 


To set a breakpoint which will automatically av, 


open and examine a specified address ,x 


To remove a specific breakpoint 

To remove all breakpoints 

To check the status of breakpoint n 
To proceed from a breakpoint 

To set the proceed count and proceed 


To proceed from a breakpoint and there- 
after proceed automatically 


Type this 
adr $nB 
adr$B 


adr$$nB 
adr$$B 


Pt snp 
adr (x)$B 
adr (x)$$nB 
adr (x)$$B 


O$nB 
$B 
$nB/ 
$P 
n$P 


_xompls: 


CAR$8B 
303$B 
CAR$$8B 


ZOE 3 $58 
7+6(AC3)$5B 
ABLE (AC4)$B 
Z+6(AC3)$$5B 
ABLE (AC4)$$B 


0$8B 
$B 


$P 


Conditional Break points 


To insert a conditional instruction (inst), or 
call a conditional routine, when breakpoint 
n is reached 


$nBt+1/ 0 inst 
For example, 
$2B+1/ 0 CAIE 3,100 
If the conditional instruction does not cause 

a skip, the proceed counter is decremented 

and checked. If the proceed count <0, a 


break occurs. 


If the conditional instruction or subroutine 
causes one skip, a break occurs. 


If the conditional instruction or subroutine 
causes two skips, execution of the program 
proceeds. 


Starting the Program 
To start at the starting address in JOBSA $G 


LOC$G 
IRST 2, @JOBOPC$X 


returns fo program 


after $C and .DDT 





To start, or continue, at a specified address 


To execute an instruction 


command sequence 
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Searching Type this Example 


To set a lower limit (a), an upper limit a<b>$W 200< 250>0$W 
(b) , a word to be searched for 
(c), and search for that word 


To set limits and search for a not-word a<b>c$N 351< 721>0$N 


To set limits and search for an effective 


address a<b>c$E 401<471>LOC+6$E 


To examine the mask used in searches 


(initially contains all ones) $M/ $M/ ia] 
To insert another quantity n in the mask n$M 777000777777$M 


Zeroing Memory 


To zero memory, except DDT, locations 


20-137, and the symbol table $$Z 


To zero memory locations FIRST through 


LAST inclusive FIRST<LAST $$Z 


Special Characters Used in DDT Typeouts 


Breakpoint stops 
Break caused by conditional break 
instruction 


Break because proceed counter<0 >> 
Undefined symbol cannot be assembled U 


Half-word type-outs Ln (401 )402 YO oy UO? 


Left hand is enclosed in parentheses 
Unnormalized floating-point number #1, 234E+27 


To indicate an integer is decimal, the $1OR 77= 63. 
decimal point is printed 


Illegal command 
If all eight breakpoints have been assigned 


RUBOUT echo 


Paper Tape Commands (Available only in EDDT 
To punch a RIM10B loader 


4, 


To punch checksummed data blocks where 
ADR1 is the first, and ADR2 is the last 


location of the data ((TAPE ) is'#R) ADRI<ADR2 (TAPE 
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Paper Tape Commands (cont) 


To punch a one-word block to cause a 
transfer to adr after the preceding pro- 
gram has been loaded from paper tape 


To read (Yank) a tape into core starting at 


ADR1, up to ADR2 


To verify a tape with core, starting at 


adr$J 


adr l< adr2$Y 


adr l<adr2$V 





ADRI, up to ADR2 
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EXAMPLES — 


DDT 


3 
rs 


PROGI$:)) 
4505$3B 9 


$3B+1/ pj O-f CAIE AC1,100y 


$3B+2/—p} 0 pj 200y or 200$PQ 


$G,J 


$3B>>4505) — 


CTRSE, 


4517/—| SETZM Xp 
4721/ >| MOVEM 2,CTRy 
5000/->| MOVE 3,@4721y 


Select the appropriate Symbol Table. 


Set a conditional breakpoint (break~ 
point #3 at location 4505). 


1. Insert a conditional instruction 
at $3B+1; if the execution of 
this instruction does not cause a 
program counter skip, decrement 
and test the proceed counter 
($3B+2); if a skip occurs, halt 
at breakpoint. 


2. Set the proceed counter at 200. 
If execution of instruction at 
$3B+] does not cause a program 
skip, decrement the proceed 
counter and test for less than or 
equal to O; if test succeeds, halt 
at breakpoint; if test fails, con- 
tinue execution. 


Begin execution of program under 
DDT control. 


Breakpoint 73 occurs; the >> indicates 
that the instruction at $3B+1 did not 
cause a skip, but that the proceed 
counter did reach 0. 


Search for and type out all instruction 
words which reference the location 


CTR 


(indirectly addresses CTR through ad- 
dress: 4721) 


4003, user — goeegffooeege — 


SA$SHBUFF1/—b] (4003) 4502[ -p| (0000) 0000) 


4003<4502>$$Z 


4003/-e 0-0 000067777777€INE-FEED)) 
4004/ | 0 -e -9980 (CINE-FEED) 2 
4005/-el 0 -F112.34E5 (CINE-FEED)¥J 


4006/1 0 Ae TEXT% 2 


O$3BS$Py 


EXIT 


4C y 
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Type out the contents of location 
BUFFI in half-word, current radix 
mode; type out the contents of the 
last address typed (4502). 


Zero out core from location 4003 
through 4502, inclusive. 


Enter the octal value 000067777777 
into location 4003: open next loca~ 
tion. 


Enter the fixed decimal value -9980 
into location 4004; open the next 
location. 


Enter the floating point value 12.34 
with an exponent of 5 into location 
4005; open the next location. 


Place the ASCII characters "TEXT" 
into location 4006, left justified. 


Remove breakpoint #3 and resume ex- 
ecution, 


Program execution is finished; auto- 
matic return to the Monitor. 


DIAGNOSTIC MESSAGES 


Table DDT-2 DDT Diagnostic Messages 


? An illegal command has been entered or an attempt has been made 
to select more than eight breakpoints. 
An undefined symbol which cannot be assembled has been 
entered. 
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| CROSS-REFERENCE LISTING (CREF) | 
FUNCTION To produce a sequence-numbered assembly listing 


followed by one to three tables, one showing cross 
references for all operand-type symbols (labels, 
assignments, etc.), another showing cross references 
for all user-defined operators (macro calls, OPDEF's 
etc.), and another (if the proper switch is specified) 


showing the cross references for all Op codes and SAU 


seudo-o codes (MOVE, XALL ae 
pseude pp gy, pid laggy 





Heat G E™! dof 
The input to CREF is a nodified bsgmbly lising file Le 


y Forks 
created during a Meréro-10 Snel wher the ie 


switch is specified in the command sitfng. 
@ Provides anslaval uable’did for program debug- 
ging and modification 


ENVIRONMENT 












Minimum Core 


Additional Core Takes advantage of any additional core available, 
as necessary. 


Equipment Required One input device (normally disk) which contains 
the modified assembly listing file; one output device 
(normally the line printer) for the listing. 





CREF~1 





<= 
© 
_— 
< 
= 
ad 
= 
= 
= 


.R CREF J 
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COMMANDS 


General Command Format 


filename.ext 


output-dev:<+— input-dev 





output-dev 





rey 
Laan, cs 
en 
Sot oe 
aes 
ores aed 
whe 
Eee 
iS 
aes 
ae 
gncenest 
& 
% 
<2 
antiooe 
& f% 
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Sooner 
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x 
Aeron 
© 
i 
ie, 
4% 
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= 
Boao 
fain 
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gone 
Boot 
2 
cy 
FER 
thé 
pee 
Freee 
Stowe 
Swe 
ere 
Ford a 
een ee th 
- 
“baca 
Se ote? 
oe 
yen einone 
a 
Sy 
a 
on 
Sree 
ran 
a 


Tis, 






: only) 


or DTAn 


filename .ext[ proj , prog] 


t-dev 


filename .ext (DSK 
[ proj prog] 


INpU 


Disk File Command Format 
DSK 
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EXAMPLES 





hte 


“A 
O 
ae 
O 
x 
= 
Oo 


eo 


iy gig 
Rog fl 


# 


:TXCALCY 


,/C#—DTAI 
THERE ARE NO ERRORS} 


PIL 


PROGRAM BREAK IS 003771, 
6K CORE USED, 


*8CQ 
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Err 


SWITCHES 


Switches are used to specify such options as 


Magnetic tape control, and 


List selection. 


2. 


All switches are preceded by a slash (/). 


CREF Switch Options 


Table CREF-1 


tS 


7IM G 
toakcall 
tT pA 


Do € 
& a 
® a 


af beri 


.% 
ns 
& 

s 





fo mach 


£05 
Toa 


magn 


¢ 


a 
oY 
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qram 
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dvance rac 
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aiv|=l|O nie lS=IN as 


Switch 
A 
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EXAMPLES 





»R CREF} 


* /Mt—MTAI 


Wp 


—A 
¥ 
a 
Lu 
> 
x 
WY 


*DTAS 


*9Cy 


-KJOBJ 


‘CREF-5 


DIAGNOSTIC MESSAGES 


Table CREF-2 CREF Diagnostic Messages 


?dev NOT AVAILABLE Device is assigned to another job. | 
2?CANNOT ENTER FILE fnme.ext DTA or DSK directory is full; file cannot be entered. | 
2? CANNOT FIND FILE fnme.ext The file cannot be found on the device specified. 


2? COMMAND ERROR 

2 DATA ERROR DEVICE dev: 
?IMPROPER INPUT DATASZ 

? INPUT ERROR ON DEVICE dev: 
? INSUFFICIENT CORE 


Error in last command string entered, 


Read or write error. 
Input data not in CREF format. 
Read error has occurred on the device. 


Additional core is required for execution but none 
is available from Monitor. 


flak PEAD De Coumpl) FZZE 
Ds ¢ b dake LANet athe oad 3 nb D 


he PRR E Toh pk 


ea 
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| GLOBAL SYMBOL CROSS REFERENCE LIST (GLOB) 
FUNCTION To read multiple binary program files produced by 


Macro age PHO and generate an alphabetic cross= 


referenced list of all global symbols encountered. 


~ 
ie qi 
ao 


All 
z 
Additional Core Requests additional core from the monitor as required. 


Equipment An input device for each binary file to be scanned for 
Required global symbols and one or more listing devices for 
output. 
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-R GLOBQ 


COMMANDS 


Input Command 


filename.ext,....filename.ext,dev 


e 
e 


dev 


filename.ext,....filename.ext, . «J 


dev 


: and DTAn: only) 


filename.ext (DSK 


Output Command 


devig— 


dev 


TTY 
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EXAMPLES 


oR GLOB) 


*DSK 


al aa Toe oe a 
a3 


5 Fae Bayt E 
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+— (ALTMOD p| 
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The switches available in Glob are used to determine the types of global symbols to be listed 
on each of the specified output devices. If no switches are typed, all global symbols are 
listed. 

All switches are either preceded by a slash or enclosed in parentheses and can appear anywhere in the 


output command string. However, only the most recently specified switch is in effect at any given 


time. 


Table GLOB-1 GLOB Switch Options 


2 
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Ls 3 List relocatable symbols 
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EXAMPLES 


-R GLOB) 
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TEST] .REL,SUBRTE,DSK 


*SCIENC , RETEST} 


*DTAI 


a 
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“AA 
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“ 
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2 eye 
oY 22S 


Ry 





ra 
‘oead 
open 


ez 
Bae 

eo 
ee 
fat 
pee 


£ 





Ly G4 
oy PE 
oR F 


4 


“hot 


e 





Li 
_— 
oe 
co 
=) 
—Y 


U EXTSYM 


ARR 


Bey 





Kee 





.KJOBJ 





GLOB-5 


DIAGNOSTIC MESSAGES 


Table GLOB-2 GLOB Diagnostic Messages 


a AY 
e 
J 
. 












2COMMAND SYNTAX ERROR An illegal command string has been entered. 
? DESTINATION DEVICE ERROR An I/O error has occurred on the output device. 


? DIRECTORY FULL No more files can be added to the directory of the 
output device. 








?dev NOT AVAILABLE The device either does not exist or has been as- 
signed to another job. 
? filename.ext NOT FOUND The filename.ext cannot be found in the directory 
of the device specified. 
GLOB requested additional core from the Monitor, 
but none was available. ¢ 
Table GLOB-3 GLOB Error Flags 


Multiply defined symbol (all values are shown). 





2TABLE OVERFLOW ~ CORE UUO FAILED 
TRYING TO EXPAND TO xxx 


Never referred to (i.e., was not declared external in any of the binary programs). 


Multiply specified symbol (i.e., defined in more than one pro ; but with non- 
conflicting values). In the listing, the name of the first jprogram‘in which the symbol 
was found is followed by a plus sign. a ! 


Undefined symbol . 
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F/O -99 
Vel ALF SB 


Systems Users Guide  (DEC-1@-NGCA-D) 


PIP-6 


CUSP-3 


In the switch column add note 2 to the Y switch 


(y2) and at the bottom of the page add the following: 


. Ze This is an optional switch obtained by setting 


RIMSW=1 at assembly time (see CUSP=3), 


« 


Replace section a. with the following: 


a. PIP: Assemble source file PIP.MAC, 


This file has 5 conditional assembly switches 
(WCH, DISK39,BLOC#,RIMSW,CCLSW) and 1 conditional 
parameter (SYSPP). 


WCH=9 New (I.E., PDP-10) Format DECtapes are assumed, 
WCH=1 Old (I.E., PDP-6) Format DECtapes are assumed, 


DISK3@2#8. PIP will run with 10/48 and 19/58 Monitors. 
DISK3@=1 PIP -will run with 10/38 Disk Monitor, 


BLOC#=@ BLOCK @ (DECtape) can be copied, 
BLOC#=1 BLOCK @ can not be copied. 


RIMSW=0 /Y switch option unavailable, 
RIMSW=1 /Y switch available, 


CCLSWS8 PIP will not process CCL commands 
CCLSW=1 PIP will execute CCL commands from Disk, 


SYSPPs:XWD PROJ#,PROG# If defined as shown, PIP will 
use this P,P#(I.E., 5,6) as 
the system P,P#., If undefined 
PIP uses l,l as the System 
P,P#, 


Due to the number of conditional assembly switches, 
a "normal" configuration is setup automatically at 
assembly time, It is as follows: 


WCH=f 
DISK3#9=¢ 


BLOCg=7 


 RIMSW= 


CCLSW=1 


(Continued on following page) 


#/0-47 
Vd b1#8 


For a "normal" configuration do a standard assembly 

then load and save on your CUSP. (See below for example 
Of loading and saving.) 

For other than a "normal" configuration follow the 
example below. 

To set a conditional switch, assemble as follows: 


-R MACRO ) 

*DTA,:PIP,«TTY: ;DTAm: PIP. MAC) 
WCH=1 2 

7, 

-END OF PASS ONE2 

WCH=1 2 

AZ 

NO ERRORS PEdeer eRe 

RAC 


Then load and save as follows: 


~R LOADER®Y 

*DTAw:PIP (ALTMODE) 2 
LOADER ». 

EXIT 2 

*C vw 


~SAVE DTA,: PIP) 


| PERIPHERAL INTERCHANGE PROGRAM (PIP) 


FUNCTION To transfer data files from any standard I/O device 


to any other standard I/O device; additionally, to 
perform simple editing and magnetic tape control 
functions. PIP], a compact version of PIP, per- 


forms a subset of PIP functions. 


® Handles all data formats 


@ Eliminates the need for a satellite computer 
to handle off-line data conversions 


| ENVIRONMENT | 


Additional Core 1K if disk is one of the I/O Any core greater than IK is 


devices; any core above that used for extra input buffers. 
required is used for extra l/O 
buffers. 


Equipment DECtape, disk, magnetic tape, paper tape reader, paper tape 
Handled punch, card reader, line printer, and Teletype. 





PIP—| 


INITIALIZATION 


-R PIP, oF -R PIPL) 


COMMANDS 


General Command Format 


Loads PIP (or PIP1) into core. 


PIP is ready to receive a command; an 
asterisk is typed after each requested 
action has been completed. 


destination-dev: filename .ext<— source-dev:filename.ext, ... source-n ,) 


destination-dev: 
source-dev: 


The destination device, to which the data is to be 
transferred; the source device(s), from which the 
data is to be read 


DTAn: (DECtape) | 
PTR: (paper tape reader) 
PTP: (paper tape punch) 
DSK: (disk) 
CDR: (card reader) 
MTAn: (magnetic tape) 
LPT: (line printer) 
TTY: or (Teletype) 

TTYn: 


If more than one file is to be transterred from a 
magnetic tape, card reader, Teletype, or paper 
tape reader, dev: is followed by a comma for each 
file after the first; these devices can also be fol- 
lowed by * or *.* to indicate all files are to be 
transferred. 


filename.ext (DSK: and DTAn: only) 


The filename and filename extension to be assigned 
to the file on the destination device; the filename 
and filename extension of the file(s) to be read from 
the source device. 


An asterisk can be used for source files as follows. 


- Transfer all files having the — 
specified filename. 


filename.* 


~ Transfer all files having the 
specified extension. 


ext 


If logical device SYS (the CUSP device) is a DECtape, it must not be modified using the /R or /D 


switches or any other request requiring it to be initialized for input and output at the same time. 


PIP-2 


¥, ye ~ Transfer all files. 


~ Transfer all files with 
null extensions. 


<+— The destination descriptors and the source descriptors 
are separated by the left arrow symbol (<—— ). 


Disk File Command Format 


DSK:filename.ext[ proj, prog] <protection> 


[ proj, prog] Project-programmer number assigned to the disk 
area to be used, if other than the user's project- 
programmer number. 


<protection> Protection value to be assigned to the destination 
file. If omitted, the standard protection is assigned. 


Standard Assumptions 


Unless otherwise changed by switches, all files which are on directory devices and which 

have a filename extension of .REL, .SAV, .DMP, or .CHN are copied in binary; all other 
files are assumed to be in ASCII line mode. Magnetic tape files, ugless otherwise changed 
by switches, are read in odd parity and written in odd parity it 5S6-bpi 


| | 4 
* elelaters 
sfahad ? 








Standard protection (055) designates that the owner is permitted to read or write, or change the protec- 
tion of, the file while others are permitted only to read the file. 


PIP-3 


EXAMPLES 


~R PIP) 
*LPT:<—— DTAI:FILE1,) 


*LPT:<— DTAI “N 
* DTA2:FILE2 @#— DTAI:FILE1 . TMP 


*DTA2:FILE3 @—DTAI :FILE1, FILE2) 


*DTA2:FILE3 ¢—DTAI:FILET , DTA3:FILE2 ,) 
*DSK:FILE1@— MTAI:) 


*DSK:FILEIS 177>@—MTAI:*) 
*DSK:FILEIL] ,3]@— MTAI:,) 


PIRES PIR ei) 


*#C 
.KJOB,) 


PIP-4 


Transfer the file named FILE] from 
DTAI to the line printer. 


Transfer all files with null extensions 
from DTAT to the line printer. 


Transfer the file named FILE] .TMP 
to DTA2 and give it the name FILE2. 


Transfer the files named FILE! and 
FILE2 from DTAI to DTA2, combining 


them as one file under the name FILES. 


Transfer the file named FILE] from 
DTAI and the file named FILE2 from 
DTA3 to DTA2, combining them as 


one file under the name FILES. 


Transfer the next file from the present 
position of MTA fo the user's area on 
the disk, call it FILE], and assign the 
standard protection of C55. 


Transfer all files from MTATI (starting 
at the current position of the read 
head) to the user's area on the disk, 
combining them into one file called 
FILE!, and assign protection 177. 


Transfer the next two files from the 
present position of MTA] to area 1,3 
on the disk, combining them into one 
file called FILE], and assign the 
standard protection (055). 


Transfer five files from the paper tape 
reader to one file on the paper tape 
punch. 


Return to Monitor. 


Kill the job, deassign all devices, 
and release core. 


SWITCHES 


Nonmagnetic-tape switches, when used, are preceded by a slash (if more than one is 
specified, they may be enclosed by parentheses instead) and may appear anywhere in the 
command string; however, if the command string contains commas, the switches must be 
specified prior to the first comma. 


Magnetic tape switches are enclosed by parentheses and must appear immediately following 
the device or file to which they refer. 


Switches are used to specify 


1. Particular files for transferral or aslstion: 

2; “Edi ing: 

3. Mode of transfer; 

4. Directory manipulation (DECtape and DSK); and 
5 


Magnetic tape control. 


A listing of PIP switches can be obtained by typing 
*output-dev:/Q =) 
where output-dev: may be either LPT: or TTY: 


Table PIP-Il PIP Switch Options 


af te 


Process file in } proces filetnbinny med, | inary mode. 


Suppress trailing spaces and convert multiple spaces to tabs. | 


Delete the file 









E Treat (card) columns 73 through 80 as spaces. 









F List disk directory (filenames and extensions only). 


G Ignore I/O errors. 


ra Process file in image binary mode. 
mi Process file in image mode. 


List the directory (DSK: or DTAn: only) 








NOTE: 1. Available for use in PIP]. 





PIP=5 


Table PIP-1 PIP Switch Options (Cont) 


Magnetic tape switches. A string of one or more — tape switches begins with an M 


and is enclosed in parentheses. A putts, §5 
FA Advance the tape n files. An) Abeo* b, ae £ver parity. 
Bont 


Mark EOF. 

















#nB Backspace the tape n Filles. yf 









2 200 bpi density. i: Skip to logical end of tape. 
5 556 bpi density. 

8 800 bpi density. U Rewind tape and unload. 

A Advance tape one file. Ww! Rewind the tape. 

B Backspace tape one file. 





NOTE: MTA switches always apply to the device or file immediately preceding the switches. 


Delete the sequence numbers from a fil 
Same as /S switch except sequence numbers are incremented by 1. 


FORTRAN output file format assumed as input. Convert format control characters for line 
printer listing. 


Print this list of switches. 
Rename the file. 


Add sequence numbers to the file or resequence a file already containing sequence numbers; 
sequence numbers ore incremented by 10. 


Copy blocks 0, 1 and 2 of a DTA file. Commonly used to transfer TENDMP. 
Count samarched angie brackets < >. 


Copy specified files only. | 


Perform a RIM DTA to PTP conversion. 
Source extension: Destination format: 
wRTB RIM Loader, RIMIOB File, 
XFERWD 
SAV RIMIOB File only. 
~RMT RIM10 





— 
— 


Zero out the directory (DTAn: or DSK: only). 





NOTE: 1. Available for use in PIP1. 


PIP-6 


{ 


EXAMPLES 


.R PIP) 
«DSK:/X +—DTAI:*.*) 


*DSK:(DX) — DTAI:FILET,* .REL,) 


* MTA2:/S —— CDR: |) 


*LPT:/P #—DTAI:FILE1 a 


* DTA2:FILEI/l +— PTR: J 


*TTY:/L +— DTAI: J 
nnnn FREE BLOCKS LEFT, 


filename.ext creation date) 


*DTAI:/Z0—) 
* MTA2;:(M8E) S— MTA1:(ME8) 


* MTA2:(MW) —)) 
*LPT:<— MTAI:(M2W), (MA), +) 


*MTA1:(M*# 4A) @— CDR: 


AC J 
KSOBY) 
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Transfer all Files from DTAI to DSK, 
keeping them separate and retaining 
their filenames. 


Transfer all files, except FILE! and 
any files with the extension. .REL, 
from DTAI to DSK, keeping them 


separate and retaining their filenames. 


Transfer a file from the card reader to 
MTA2 and add sequence numbers. 


Take FILET (a FORTRAN output print 
file), interpret the carriage control 
characters, and print it. 

Initialize both DTA2 and the paper 
tape reader in image mode and trans- 
fer one file from the paper tape reader 


to DTA2, calling it FILET. 


List the directory of DTA] on the 
Teletype. 


Zero the directory of DTA]. 


Transfer a file from MTAI to MTA2 in 
800 bpi, even parity mode. 


Rewind MTA2. 
Set MTAI to 200 bpi, odd parity, 


rewind the tape, and transfer the first, 
third, fourth, and fifth files to the 
printer. 


Advance MTAI four files before trans- 
ferring a file from the card reader. 


Return to the Monitor. 


Kill the job. 


~ DIAGNOSTIC MESSAGES 


Table PIP-2 PIP Diagnostic Messages 


?4K NEEDED S AK is not currently available but is needed 
when a disk is present in the system. 

? DECTAPE I/O ONLY S 1/O device for copy block 0 (/U) must be 
a DECtape. 

?DEVICE dev:DOES NOT EXIST 1/O Either device name has been misspelled 
or there is no such device. 

? DEVICE dev:NOT AVAILABLE I/O The device has been assigned to another 
job. 

? DIRECTORY FULL FR There is no room for an entry in a DEC- 
tape directory. 

DISK DIRECTORY READ //O Followed by a second message (see 
Table PIP-3). 

?DISK OR DECTAPE INPUT REQUIRED 1/O This command requires a directory device 
for input. 

?DTA TO PTP ONLY RIM DTA input and PTP output must be speci- 

| fied for /Y. ( 
R 
IM 





? FILE filename .ext ILLEGAL EXTENSION Extension for /Y request must be .RMT, 


.RTB, or .SAV. 
PEILE filename. ext ILLEGAL FORMAT 7 


R 
FILE PROTECTION FAILURE DURING S Each file requested does exist, but one or 
more was unavailable for processing. 
This message is never fatal. 


(/X, /Z, /D) REQUEST 
NOTES: 1. All fatal diagnostic messages are preceded by a question mark (?). 


Zero-length file; or 

Requisite job data info not available; or 
Block overlaps previous block (RIM 10) or 
EOF found when data was expected, or 
A pointer word was expected but not 
found in the source file. | 














2. Type of message: 


C Command string error 

FR File reference error 

/O I/O error 

RIM Read-In-Mode specification error. 
S Other types of errors 








3. These messages are nonfatal if the /G switch is used; otherwise, they are fatal and are 
preceded by a ?. 
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Table PIP-2 (Cont) PIP Diagnostic Messages 


Disk file named is currently being pro- 
cessed by another job. 


Filename.ext not found during LOOKUP. 


Indicates that 
No filename was specified for DTA 
output file; or 
A reject occurred on a /R request 
for disk file; or 
: guia filename was specified for a 


/R request on DTA. 
?filename.ext INCORRECT PROJECT- The project-programmer number specified 
PROGRAMMER NUMBER for a DSK file is incorrect. 
INPUT DEVICE dev: FILE filename. ext9 l/O Followed by a second message (see 
Table PIP-3). 


A line >140 characters was detected in the 
source file 


Load point on a magnetic tape file has 
been reached before the tape has been 
snr Sea Ge noe 3 iles specified 


WMeeaga: 


?filename.ext FILE WAS BEING MODIFIED 


?filename.ext FILE WAS NOT FOUND 


?filename.ext ILLEGAL FILE NAME 





wail 
7m “< 
7 xe) 
are 





?LINE TOO LONG 






?LOAD POINT BEFORE END OF (MB) n(UP 
REQUEST 






a given but £ seni without 
provision for this. 


No such file found during PIP directory 


?NO BLOCK 0 COPY 
?NO FILE NAMED filename.ext 


search. 
?NO FILE NAMED QPIP The data file for the /Q switch is not 
available. 


OUTPUT DEVICE dev: FILE filename.ext 


Followed by a second message (see 


Table PIP~3. 





NOTES: ]. All fatal diagnostic messages are preceded by a question mark (?). 
2. Type of message: 


C Command string error 

FR —s- File reference error 

VO WOerror 

RIM Read-In-Mode specification error. 
S Other types of errors 


3. These messages are nonfatal if the /G switch is used; otherwise, they are fatal and are 
preceded by a ?. : 
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Table PIP-2 (Cont) PIP Diagnostic Messages 


?PIP COMMAND ERROR 


~ Illegal format for command string; or 
Nonexistent switch requested; or 
Filename.ext other than 

* (or *.*) requested for 


a nondirectory device; or 
. The illegal switch combination RX. 


?filename.ext PROTECTION FAILURE FR Same as "FILE PROTECTION FAILURE 
DURING ..." message except that the 
processing halts. 





?TERMINATE /X MAX OF 999 FILES S 
PROCESSED 


The /X switch specified for nondirectory 
device source files has processed the 
maximum number of files (999). 


?TOO MANY REQUESTS FOR dev: Conflicting parity and/or density requests 
have been given for a magnetic tape. 


?TRY PIP az During a PIP] run, a switch or function 


which is not present in PIP] has been 
NOTES: 1. All fatal diagnostic messages are preceded by a question mark (?). 




















requested. 





2. Type of message: 


C Command string error 

FR File reference error 

V/O 1/0 error 

RIM  Read-In-Mode specification error. 
S Other types of errors 


3. These messages are nonfatal if the /G switch is used; otherwise, they are fatal and are 
preceded by a ?. 


Table PIP-3 Secondary PIP I/O Diagnostic Messages 


BINARY DATA INCOMPLETE. PTR Length of block disagrees with word 


count. 


BLOCK TOO LARGE DTA DTA link number>] 101,. 


CHECKSUM OR PARITY ERROR! | al ““Resdicrawitareroe. 
INPUT BUFFER OVERFLOW! All except DTA Block too large for buffer. 


DEVICE ERROR! All The data control unit has detected the 
| loss of data. 





NOTE: 1. These error conditions are nonfatal if the /G switch has been specified. 
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Table PIP-3 (Cont) Secondary PIP I/O Diagnostic Messages 


I 


MTA The end of tape has been reached. 


PHYSICAL EOT 


WRITE (LOCK) ERROR DTA, DSK, MTA, |. Attempt has been made to write ona 
write-locked file. 


7-9 PUNCH MISSING! CDR Binary card lacks 7~9 punch. 


NOTE: 1 These error conditions are nonfatal if the /G switch has been specified. 


oo 


IK Mersion of PIP (PIP1) 









Limitations 


1. Zand MW requests ignore all source devices. 


2. B switch included since REL, SAV, DMP, and CHN files are not automatically copied in 36-bit 
bytes. 


Error messages assume all I/O devices are DECtape. 
Neither project-programmer numbers nor protection can be specified for disk files. 


The * cannot be used for filenames or extensions. 


Oo Oa KL W 


SAV files cannot be successfully copied with PIP1. 
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DECTAPE FORMAT CONVERTER (CONVRT) 
FUNCTION To convert DECtapes from the old format to the 


new format (or vice versa). 
The new format 


@ Increases DECtape processing speed by allo- 
cating blocks in a nonconsecutive manner so 
that a continuous read is possible 


e Allows for file deletion to free assigned 
blocks for use by subsequently written files 


ENVIRONMENT 


Equipment One or more DECtape units for input: one DECtape unit for 
Required output. 









— 


Note: CONVRT runs on the PDP-6 or PDP-10. However, it does not use the LOOKUP or ENTER 
programmed operators or do standard I/O. Asa result, the Monitor is not aware of the directory of 
the output tape (or the input tape) and the tape must be assigned appropriately if it is to be used on 
the machine on which it is converted. 


CONVRT-1 


INITIALIZATION 


-R CONVRT) Loads the DECtape Format Converter 


program into core. 


7 The program is ready for the first 
command, 
COMMANDS 
General Command Format 
DTAn: #—DTAx:,DTAy:..... DTAz: (LTMODE 
DTAn: The DECtape on which the converted output is to 


be written. Output is assumed to be in new format. 


DTAx:....DTAz: The input tape(s) containing the files to be con- 


verted; input is assumed to be in old format. 


a The output DECtape is separated from the input 
DECtape(s) by the left arrow symbol. 


CONVRT-2 


EXAMPLES 


.R CONVRT) 

*DTA2: @— DTAI: (QLTMODE) ,) 

DTAI FINISHED . . .) 

*DTA3: @— DTA4:, DTAS: 2 
DTA4 FINISHED. . . WAIT, 

DTA5 FINISHED . . . 

*#C Y) | 

.KJOB,) 
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ca ee ie Bags 84 Pep A fam ind Lone eS 

Convert tne files on DIA! told format) 
Pied 3 § 

h iets ‘ ee CaS a § sh eran ee We as Ta 

TO NOW TOPIVOT GMa Gaga mem tO wirsd.« 


— ee ES Py Tt ‘ ud nye gp 
Convert fhe files on DTA4 and DTAS 
Id format) | 


rae 
} fo new format and 


SWITCHES 


Switches are used to specify such options as: 





%. 
& 
we 


normally apply 
iven for that 


1. The format of a tape, 





2. The specific files to be copied, 
3. Directory handling, and 


4. Processing continuation. 







All switches can either be preceded by a slash or enclosed within parentheses. 
only to the device with which they appear and must be specified before any{ Mlename .ext 
device. 


Table CONVRT-1. CONVRT Switch Options 


Copy the named files only. 
Copy other than the named files. 


Continue processing. Used only after the operator has mounted a new output reel 
wv ae r, k 3 
following the MOUNT NEW OUTPUT TAPE message. 


List the directory (source tapes only). See format of list shown below. ( 


Tape is in new format (new format is assumed for the output tape unless otherwise 


specified) 


Tape is in old format (old format is assumed for all source tapes unless otherwise 


i 


Zero out the fape directory (output tape only). 





Format of DECtape Directory Listing (/L Switch) 
If DECtape is in old format: 


Dump mode files 





filename ext date Ist block command list word 

CONBSV DMP 2-SEP-67 2 (-n,y in decimal) 
-5060, 59 

CONB 2-SEP-67 108 (last block in use) 
207 | 
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If DECtape is in new format: 


Dump mode files 
# of 1K blocks 





filename ext date # of blocks in file used 
CONBSV SAV 2-SEP-67 106 5 
CONB 2-SEP-67 100 


NOTE: When requesting a listing of a directory from a new format DECtape, the user must include 
the /N switch on the source side; otherwise, an old format DECtape is assumed. 


iLPT:/L<—DTAI:/N (ALTMODE 


CONVRT-5 


EXAMPLES 


R CONVRT) 
*DTAS:/Z +— DTAI:(C)JOBI , JOB4, JOB6, DTA2:(D) 
JOB.REL@LIMODB) ,) 


DTAI FINISHED . . . WAIT, 


MOUNT NEW OUTPUT TAPE ,) 
/2/C@UMOD 


DTA2 FINISHED . . ‘-) 


#C Y 
KJOBA) 


CONVRT-6 


Perform the following steps: 
1. Zero out the directory of DTAS. 


2. From DTAI, convert files JOBI, 
JOB4, and JOB6 (all in old for- 
mat) and write them on DTAS. 


3. From DTA2, convert all files 
except JOB.REL and write them 
on DTAS. 


The reel on DTAS is full; mount new | 
output reel and type /Z/G to zero 
the directory of the new output tape 
and to continue processing. 


Return to the Monitor. 


Kill the job, deassign all devices, 
release core. 


DIAGNOSTIC MESSAGES 
Table CONVRT-2 CONVRT Diagnostic Messages 


? filename.ext DIRECTORY ENTRY . Anold format file has word four of the 
INCONSISTENT directory entry greater than zero and the 
extension is neither CHN nor DMP. 


. Anold format file has the extension SAV 
and word four of the directory entry is zero. 


?DTAn DATA ERROR An error has occurred while reading or writing a file. 
The file is deleted from the directory; the directory 
is written on the output tape before this message is 
typed. 


- 2DTAn DEVICE NOT AVAILABLE The DTAn specified has been assigned to another 
ee | job. 
?DTAn DIRECTORY WRITE DATA ERROR A parity or data error has occurred while writing 
| the directory on the output tape. 


DTAn FINISHED . . . (WAIT) Conversion has been completed for all files on the 
specified input tape. If the word "WAIT" follows 
the message, more input files are to be processed; 
if it does not follow, the entire conversion process 
is complete and the output reel can be dismounted. 


?DTAn NO DIR A directory block is not recognizable. 


?DTAn WRITE (LOCK) ERROR A write error has occurred on the output tape; the 
tape is probably write locked. 


? filename.ext FILE NOT FOUND A file specified after a /C or /D switch cannot be 
found on the input tape. No conversion has been 
performed for this tape and only those files men- 
tioned prior to this one have been checked. The 
run is terminated. 


2 ILLEGAL COMMAND An unrecognizable, incomplete, or illegal command 
string has been typed. The run is terminated. 


? ILLEGAL SWITCH An unrecognizable or illegal switch has been typed. 


?IMPOSS. SAVED FILE FORMAT This message should never occur. However, 
during a new~-to-old format conversion, this type- 
out indicates one of the following conditions. 













1. Overlapping blocks occurred. 


2. There are more words in the file than are indi- 
cated by the number of 1K blocks needed to 
load the file. 
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Table CONVRT-2 (Cont) CONVRT Diagnostic Messages 


2? IMPOSSIBLE CONDITION FOUND 













This typeout should never occur. If it does appear, 
it indicates one of the following conditions. 


1. The fourth word in the directory of a saved file 
on an old format DECtape is not negative. 


2. There are no blocks associated with a 
filename.ext in a new format tape directory. 







3. The word count in a block of a new format saved 
file is greater than 128. 


? MORE CORE NEEDED Insufficient core is available for processing the last 
command string. 

(@ELL) MOUNT NEW OUTPUT TAPE The current output tape if full. Dismount the tape, 
mount a new tape, and type /G to continue. 

@ELL) ? MOUNT NEW OUTPUT TAPE An incorrect response to the previous typeout of 
this message was entered. 

?dev: NOT A DECTAPE All selected devices must be DECtapes. 
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| CODE TRANSLATOR (CODE) 


This section was not available at publication time, but will soon be available as an insert. 


If you do not receive this insert, please write to: 
DEC Program Library 
Digital Equipment Corporation 


146 Main Street 
Maynard, Massachusetts 01754 


CODE-I 


SOURCE COMPARE (SRCCOM) 


(Version 010) 


FUNCTION To compare, line by line, two versions of a source 


file coded as lines of ASCII characters and to output 


any differences. 


m ENVIRONMENT 


Additional Core 













The minimum core allows for comparing files with minimal differences. 
SRCCOM automatically requests more core from the Monitor when it 
needs it. Major differences can usually be handled in 3K, but for 


comparing two completely different files, enough core is required to 
store all of both files simultaneously . 


Equipment User Teletype for control: Two input devices for the two files to be 
Required compared; one output device for listing the differences. 
INITIALIZATION 


+R SRCCOM @ Loads the Source Compare routine. 












= Source Compare is ready to receive 


a command. 
COMMANDS 


General Command Format 





list-dev:filename.ext+ input 1-dev:filename. ext , input2-dev:filename.ext ¢ 


list-dev: The device on which the differences are to be listed. 
LPT: (line printer) (Any device 
TTY: (Teletype) that can output 


MTAn: — (magnetic tape) ASCII characters) 
DTAn:  (DECtape) 
DSK: (disk) 


Steyn | OCTOBER-DECEMBER, 1968 
| SRCCOM-1 


input 1-dev: The devices on which the two source files to be 


input2-dev: compared are located. 
MTAn: (magnetic tape) (Any device 
DTAn: (DECtape) that can input 
DSK: (disk) ASCII characters) 
PTR: (paper tape reader) 


filename.ext (DSK: and DTAn: only) 


The filename and extension of either of the input 
source files. | 


The filename and extension to be assigned to the 
output list file. (SRCCOM.LST is assumed if no 
filename is specified.) 


“ The output device is separated from the input source 
file devices by the left arrow symbol. 
Default Conditions 


TTY: is assumed as the output device if no other device is specified. 
DSK: is assumed as input device *1 if no other device is specified. 


Input device *1 is assumed as input device *2 if no other device is specified. 


switch ES| 


Switches are used to specify the manner in which the comparison is to be done. 


All switches consist of a single character preceded by a slash (/), anywhere in the command string. 


OCTOBER=DECEMBER, 1968 
SRCC OM-2 | 





Table SRCCOM-1 


Source Compare Switches 


a a 


/B 
fC 
“Ss 
Jn 


.R SRCCOM @ 
*LPT: -DTA2:SOURCE.001 ,DTA3:SOURCE.002 @ 








are completely ignored. 


/S is also implied. 


*LPT: DSK:TRY1,DSK:TRY2 @ 


el Om 
.KJOB @ 


Nea 
sys dbep-lS\, SRCCOM-3 


Enables the comparing of Blank lines. Normally blank lines 


Comments (all text on a line beginning with a semicolon) are 
ignored. /C will not cause a line consisting entirely of a 
comment to become a blank line which will be ignored. 


Spacing (spaces and tabs) is ignored. 


(n= 1, 2,...,9) A "match" consists of n lines. (n is normally 3.) 
n successive lines must be found identical in the two input files 
for a "match" in the two files to be found. When a match is 
found, all differences between the current match and the pre- 
vious match are listed. The first line of the match is also listed 

in order to make the location in the file easier to find. 















Compare the source file SOURCE.001 
on DTA2 with the source file 
SOURCE.002 on DTA3 and list all 


differences on the line printer. 


Compare the two files, TRY1 and TRY2, 
both of which are on the disk, and 
list the differences on the printer. 


Return to the Monitor. 


Kill the job, deassign all devices, 
and release core. 


OCTOBER-DECEMBER, 1968 


Table SRCCOM=2 


Example of Source Compare Output 


SRCCOM output File 1 input File 2 input 






FILE 1). FILE #1 
FILE 2) FILE #2 


lipo FILE #1 
A 








FILE #2 
A 






KREREEEEE 


N28 Ww 


KERERE 






2b A 
2) 5 
2) W 





RRERRERERRERERE 





page | 

FILE #1 

A 

B 
cee: 
D 

E ae 
. ae 

G 

H 

I ae 
Oe ae 

K 

L nee 
M ae 

page 2 

N 

O 

p 

Q 

R 

S 

T 

U 
Ee 
Ww OO 
X 

¥ 

Z 


page | 


FILE #2 


— 


The numbers with the Barrows in the SRCCOM listing are page numbers referring to 


the input files. 


*A line identical to both input files is listed to help find the location of the differences 


within the two files. 
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OCTOBER-DECEMBER, 1968 


DIAGNOSTIC MESSAGES 


Table SRCCOM-3 Source Compare Diagnostic Messages 


?2K CORE NEEDED AND NOT 
AVAILABLE 


?BUFFER CAPACITY EXCEEDED 
AND NO CORE AVAILABLE 


2COMMAND ERROR 

?DEVICE device NOT AVAILABLE 
?FILE 1 READ ERROR 

? FILE 2 READ ERROR 

?INPUT ERROR - filename. ext 
FILE NOT FOUND 


?NO DIFFERENCES ENCOUNTERED 


?OUTPUT DEVICE ERROR 


POUTPUT INITIALIZATION ERROR 


SRCCOM needs 2K in order to initialize IO de- 
vices and the core is not available from the 
Monitor 


The buffer is not large enough to handle the 
number of lines required for looking ahead and 
no more core is available from the Monitor. 


Error in last command string entered. 
One of the input devices cannot be initialized; 


generally, the device either does not exist or 
has been assigned to another job. 


An error has occurred on the first input device 
specified in the command. 


An error has occurred on the second input device 
specified in the command. 


The specified filename can't be found. 


No differences were found between the two 
source files. 


An error has occurred on the output device. 


The output device cannot be initialized; the de- 
vice either does. not exist or has been assigned 
to another job, the device is not an output de- 
vice or the filename could not be entered on the 
device. | 
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| BINARY COMPARE (BINCOM) 


FUNCTION To compare, word by word, two versions of a binary 


(.REL) program file and to output any differences. 


| ENVIRONMENT 
All 


Minimum Core IK if output device is other than DTAn:, MTAn:, or DSK:; 
otherwise 2K. 


Equipment Two input devices for the two files to be compared; one output 


Required device for listing the differences. Both input files can be on 


disk. 





BINCOM-=1 


INITIALIZATION 


.R BINCOM ) 


COMMANDS 


General Command Format 


Loads the Binary Compare routine. 


Binary Compare is ready to receive 
a command. 


list-dev: filename. ext<— input1-dev: filename.ext, input2-dev:filename -ext ) 


list-dev: 


inputl-dev: 
input2-dev: 


filename.ext (DSK: and DTAn 


“ys 


Foci } * . ek ey por : cas 3 i f° ok i 
ine device on which tne differences are to be jiisted, 


LPT: (ine printer} 
TTY: (Teletype} 
MTAn: (magnetic tape) 
DTAn: (DECtape) 
DSK: (disk) 


i cae is > i 
bTY: Is assumed, 


DTAn: (DECtape) 
DSK: (disk) 
CDR: 


£ $ H %, 
roe es ee pre rd ORY FE 
i So ke E Oo ¢ oe co: ey S| 2 


f ‘ 
PTR: (paper fape reader) 

f 2 ‘ 
MTAn: = Grnagnetic tape) 


rhe filename and extension of either of the input 
binary files. 

The filename and extension to be assigned to the 
output list file. 
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EXAMPLES 


.R BINCOM) 


*LPT 





, 
rat 


PROGI.REL) 


:PROGI.REL, DTAT: 


+— DSK 


° 
e 


> ok 


amy oe gS 
<2 o 
Siw Sweet 


% 
et 


” Sk 
s 


gaye 
mo 


+ 





ts, 


us 


ed 





NO ERRORS ENCOUNTERED, 


*DTAI 
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BINA, DTA2: 








1, filel-word file2-word XOR 





CQ 





hae 


Bont 
O 


% 
bd 


iv 
3 
ea 
ee 


‘ 
a8 


setegyny 


eed 


fe, 
oy, 
stb? 
oe 
wd 


Ne ewan 





.K JOB) 
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DIAGNOSTIC MESSAGES 


Table B C-1 = Binary Compare Diagnostic Messages 


PCOMMAND ERROR Error in last command string entered. 


?END OF FILE PHASE ERROR One input file is longer than the other. 


?INPUT INITIALIZATION ERROR 













One of the input devices cannot be initialized; 
generally, either the device does not exist or it 
is assigned to another job. 


NO ERRORS ENCOUNTERED No differences were found between the two binary 
program files. 


POUTPUT INITIALIZATION ERROR 















The output device cannot be initialized; generally, 
either the device does not exist or it is assigned to 
another job. 


Error Differences 


Whenever a difference is encountered between the two files being compared, a line is printed on the 


listing device in the following format. 


, 


filel-word file2—word XOR of both words 
CS 


BINCOM-4 


Replacement for Table BC-1 , page BINCOM-4. 


Table BINCOM=-1 Binary Compare Diagnostic Messages 


?COMMAND ERROR Error in last command string entered. 


?DEVICE dev: NOT AVAILABLE Device has been assigned to another job or does 
| not exist. 
?END OF FILE PHASE ERROR One input file is longer than the other. | 


?FILES BEING COMPARED ON Files cannot be compared from the same input 
SAME INPUT DEVICE device unless that device is DSK:. 

? INPUT ERROR filename. ext The file specified could not be found on the in- 
NOT FOUND put device. 


NO ERRORS ENCOUNTERED 
















No differences were found betweent he two 
binary program files. 


POUTPUT INITIALIZATION ERROR The file cannot be entered. 
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ALGEBRAIC INTERPRETIVE DIALOGUE (AID) 
decal sede To provide users with a personal computing service 


for solving complex numerical problems 


ENVIRONMENT 


11K (with 1K of user data area) | 


- Additional Core Up to 3K additional (providing a total of 4K 
of user data area) | 
Equipment May use DECtape, disk, etc., for filing 
Required and subsequent recalling of data 















Lon 


Note that AID will not run in 16K of core if Monitor occupies more than 5K of that core. 


AID-1 


INITIALIZATION 


R AIDS Loads the AID program into core 
AID (revision date) AT YOUR SERVICE . . . J AID responds with message when 
| loaded. 


AID is ready to receive a command. 


COMMANDS 


Format Rules 


1. Only one step (command) can be typed per line, and only one line can be used for each 
step. 


2. The text of each step begins with a verb and terminates with a period followed by a 
carriage return. 


3. Words, variables (1-character identifiers), and numerals can neither abut each other nor 
contain imbedded spaces; spaces cannot appear between an identifier (when it appears in an array, a 
formula, or a function) and its nGeecisic? grouped Operators and arguments. Otherwise, spaces can be 
used freely. 


4. Characters can be seed by striking the RUBOUT key once for each erasure; an entire 
line can be deleted by typing an asterisk followed by a carriage return. 


5. Adirect step is interpreted and executed by AID immediately (i.e., tsi owtng the 
terminating carriage return typed by the user). No step number precedes a direct step; the line begins 
with the verb of the command. 


6. An indirect step is entered by preceding the step with a numeric label containing both 
an integer and a decimal portion (e.g., 1.23); maximum number of significant digits in a step number 
is nine. Indirect steps are organized into parts according to the integer portion of their step number; 
all indirect steps having the same value in the integral portion of their step number belong to the same 
part. Indirect steps are not executed immediately but are stored for later execution (e.g., by a DO or 


TO command). 
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Identifiers Single alphabetic characters (A through Z, a through z) 


Defined by a value SET x = value. (Set A= 2*5.7.) 
DEMAND x. (Demand A.) 


Defined by an expression 


Arithmetic Formulas: 


LET x = arithmetic formula Let A= sart (b}tc/d. 
Boolean Expressions (Propositions): 
LET x = proposition b = true 
c = false 
Let A=bandc. 


User-Defined Function: 
LET x(arguments) = expression Let Ab,c)=b?%2+c 49. 


Indexed identifiers (arrays) 
MTZ log ees) 


One to ten indices (subscripts) allowed. 
Each subscript can be in the range -250 through +250. 


SPARSE items in an array: 


LET x BE SPARSE. Sets all undefined items in array "x" to 0 and 
saves the core which would be occupied by 
those items. 


Arithmetic Operators (listed in order of precedence) 


Standard Designation | AID Symbology 


[x| 1x! Absolute value of x 

[ ] Ist level grouping 

() 2nd level grouping 

xe x raised to the power of e 


a+b, a(b), oraxb a multiplied by b 


a/b ore a divided by b 
ath a added to b 


a-b. b subtracted from a 


NOTE: Within nested pairs of brackets (or parentheses), the order of evaluation 
is from the innermost pair outward. 
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AID functions 


arg (x,y) 


cos(x) 


dp (x) 
exp(x) 


first (i=iterative 


Computes angle between +x axis of x,y plane and line joining point 
0,0 and point x,y. Answer is in radians. 


Computes cosine of x (x must be in radians and less than 100). 
Returns the digit part of x. 


Exponential function: e*, where e is Euler's number (2. 178281828) 
(e% must be fess than 19100) 


expression: i proposition) Finds first value in an array to satisfy 
the proposition, using i as an index. Result = value of i 


fo(x) Returns the fractional part of x. 

ip(x) Returns the integer part of x. 

log(x) Computes natural log of x (x must be greater than zero). 

max(i=iterative clause: i expression) | *Computes expression iteratively for each 
or value of i and returns largest value. 

max (series) Returns the largest value in the series. 

min(iterative clause: i expression) Computes expression iteratively for each 
or value of i and returns smallest value. 


min(series) 


Returns the smallest value in the series. 


prod(i=iterative clause: i expression) | Computes expression iteratively for each 


value of i and returns the product of all the 


or 
computed values. 
prod (series) Returns the product of the series of values. 
sgn(x) Signum function: x > 0, signum = +1; 
x = 0, signum = 0; 
x <0, signum = -1 
sin(x) Computes sine of x (assumed to be in radians; x must be > 0). 
sqrt (x) Computes the square root of x (x must be > 0). 
sum(i=iterative clause: i expression) Computes expression iteratively for each 
or value of i and returns the sum of all the 
computed values. 
sum/(series) Returns the sum of the series of values. 
tv (proposition) Returns the truth value of the proposition: 
true = | 
false = 0 
xp (x) Returns the exponent value of x. 
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User-Defined Functions 
f(a,b,c,...) = expression 
f function identifier (any single alphabetic character) 


(a,b,c,...) | dummy arguments; the use of a character as a dummy argument in 
no way affects its use as an identifier. 


expression the arithmetic expression representing the user function. 


Propositions (Boolean Expressions) 
Relational Operators: 


= (equal) # (not equal) >(greater than) <(less than) 


>= (greater than or equal to) <= (less than or equal to) 
q q 

Logical Operators: and, or | 
Negation: not 

"x = true p 

"y = falsey 

*Let z = x and y or x and (100 sqrt(959) ). 9 

“Type z.y 

z= true py 


Order of Execution: 


(1) Evaluation of expressions 
(2) Parentheses (from innermost pair outward) 
(3) Relational operations 


(4) not 
(5) and 
(6) or 


A series of relational operators (a = b>c<d) is assumed to be an and chain (a = b and b>c and 


c<d). 


Conditional Expressions 


Allows an expression to have different values depending upon which one of a number 
of conditions is true. 


A conditional expression is a series of expressions separated by semicolons, with each 
expression preceded by a proposition and a colon. The entire conditional expression 
is enclosed in parentheses (or brackets). 


(proposition: expression; proposition: expression;...... ) 


Let C(x) = («>0:x #2; x=0:0; x<O:x). 


states that: 


ifx>0, then C(x) = 2 


) 
if x =O, then C(x) 
if x< 0, then C(x) = 


il 


x 
0 
x 
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If the last expression is to be true for all cases which do not satisfy any of the other 
stated conditions, the expression can be typed without a preceding proposition. 


Let C(x) = (x> O:x 42; x =0:0;x). 


Every possible combination of the variable must be provided for, either by explicitly 
stating a proposition and an expression for it, or by simply specifying a terminating 
expression to be executed for all remaining cases. 


Table AID-1 AID Command Summary 





CANCEL. 


Cancels a currently stopped process when the 
user does not desire to resume execution. 


(CANCEL.) 


Cancels a currently stopped process which was 
initiated by a parenthetical DO. 


L 

S(m, n) 
DEMAND Las "any text" 

S(m,n) as "any 

text" 


Causes AID to type out a message requesting 
the user to supply a value for the specified 
item. Only one variable can be specified 


in each DEMAND command. 





DISCARD ITEM }DISCARD TEMa(cade), fF Deletes item *m from the external storage file 


currently in use. (Code) is optional. 


coamcacnee Ral m.n 

step m.n, p times 

step m.n for L = range \- 
part m 

part m, p times 

part m for L= range 


Executes an indirect step or part. If the DO 
command is a direct step, control returns to 
the user at the completion of the DO; if an 


indirect step, control returns to the step 
following the DO. 


same as above...) 


Initiates a new execution without cancelling 
the currently stopped process. 


L | 
S : 
S(m,n) 
form m 
step m.n | 
part m 
formula f 7 
DELETE all steps Erases the specified item from immediate storage 
all parts and frees the space occupied by it for some other 
all formulas use. 
all forms 
all values Several DELETE commands can be combined 
all a | into one. | 
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Table AID-1 (Cont) AID Command Summary 


DONE. I,O 


L 
S 
S(m,n) 
form m 
sfep m.n 
part m 
formula f AS ITEM 
all steps n (code) « F 
all parts 
all formulas 
all forms 
all values 
all 
Defines a format to be used in editing typeouts 
for purposes of readability. 
<$<r<F-<$<+-. <<< fixed point notation 
(up to nine digit 
positions plus the 
decimal point) 
ry ee eee scientific notation 
(minimum of seven 
positions, maximum 
of fourteen) 
text any text to be included 
in the line; not enclosed 
in quotation marks unless 
they are part of the text. 


D,O Continues execution of a currently stopped 
process; opposite of the CANCEL command. | 


IF Clause M 
Verb....IF proposition. 


L=m 

L = formula 
LET F(L) =m ~ 
_ F(L) = proposition 


















Skips execution of the remaining steps of a 
part during the current iteration. 







Stores the specified item in the external storage 
file currently open. Immediate storage is not 
affected in any way. (Code) is optional. 
























Can be appended to any command (except the 
abbreviated SET command) to make the command 
conditional; the command is executed only if 

the proposition is true. 





Defines arithmetic formulas, Boolean expressions 
(propositions), and user functions and associates 
them with identifiers. The formula, expression, 
or function with which an identifier is associated 
is re-evaluated each time the identifier appears 

during an execution. 







Table AID-1 (Cont) 


AID Command Summary 


LET S be sparse . fet sbespose, «| ss] Sets undefined eray elements o zero. Sets undefined array elements to zero. 





RECALL ITEM m (code). F 









L = proposition 
S(m,n) =m id 
S(m,n) = proposition 


SET 








LINE. Ss Advances the Teletype paper form one line. 
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Advances the Teletype paper form to the top 


is optional and is for documentation only. 


- RESET TIMER. Resets TIMER to zero. 








of the next page. 










Skips execution of the remaining steps of a 
part and satisfies the DO command for that 
part by cancelling any further iterations. 

Usually given conditionally. 












Reads an item, previously stored by a FILE 
command, from the currently open external 
storage file into immediate storage. (Code) 





Defines an identifier as equivalent to a fixed 
value, which is calculated once and then used 
whenever the identifier appears. A short form 
of the SET command, where the word SET and 
the period are omitted, can be used if the 
command is direct. 


Temporarily halts the current process at the 
point where the STOP command appears and 


returns control to the user. The stopped 
process can be resumed by typing GO. 


Discontinues the sequential execution of the 
part currently being executed and transfers 
control to another step or part; when the new 
part is finished, the direct command which 
initiated the execution is satisfied. 


Table AID-1 (Cont) AID Command Summary 


m Types out the specified information on the 
S user's console. Several individual TYPE 
S(m,n) commands may be combined into one (except 
proposition for TYPE "any text" or TYPE ITEM-LIST). 
“any text" 

<- 

form m The command 

step m.n : 

part m Type ... in form n. 

formula f 

F (x) 

F (proposition) 
all steps 

all parts 
all formulas 
all forms 
all values 
all 

time 

timer 

size 

item-l ist 


causes the listed items to be typed out in the 
format specified by form n. n can be a numeric 
value (e.g., Form 3) or it can be a numeric 
formula (e.g., Form (2*x-y) ). 


USE FILE filename (device) + Makes an external storage file available for 
use. The external file thus addressed remains 
open for use (by DISCARD, FILE, RECALL, and 
TYPE ITEM-LIST commands) until another USE 
command is given or the AID program is termin- 
ated. 


Command Format Symbology 


L = letter 

S = subscripted letter 

m, n, p= numeric values 

f = formula 

F = function 

range = an iterative sequence or series of values 


Type Symbology 


D = Can be given directly only 
I = Can be given indirectly only 
O = Operational command 

F = File command 

S = Special command 
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Table AID-2 File Command euhéet 


Section 
Command Format | Reference | | pCi esecription 
DISCARD ITEM m (code) oe ao ane Deletes item [ Wpeieieet eae meine emai cae le. | from the external storage file 
currently in use. (Code) is optional. 


: 
S(m,n) 
form m 


step m.n AS 


part m ITEM 


formula f 
eee n (code) . oG7 


all parts 
all formulas 
all forms 
all values 


all 









Stores the specified item in the external 
storage file currently open. Immediate 
storage is not affected in any way. (Code) 
is optional. 












Reads item *m, previously stored by a FILE 
command, from the currently open external 
storage file into immediate storage. (Code) 
is optional and is for documentation only. 


TYPE ITEM-LIST. Obtains a typeout of the directory of the 
currently open external storage file. 


USE FILE filename (device) 


RECALL ITEM m (code). 5.15 







Makes an external storage file available for 
use. The external storage file thus addressed 


remains open for use (by DISCARD, FILE, 


RECALL, and TYPE ITEM-LIST commands) until 
another USE command is given or the AID 
program is terminated. 





Section references refer to sections within the PDP-10 AID (Algebraic Interpretative Dialogue) 
Programmer's Reference Manual, DEC-10-AJAO-D. 
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Table AID-3 AID Character Set 


Standard Typing Method 
Math JOSS 
Symbol AID Symbol Model 37 Models 33 and 35 Symbo| Notes 


A through Z Strike appropriate | Strike appropriate {| A through Z 
key with SHIFT. | key; no SHIFT. 
a through z Strike appropriate | Not available; a through z 
key without SHIFT] use upper-case 
letters . 
0,1 through 9 | Strike appropriate} Strike appropriate | 0,1 through 9 
key; no SHIFT. key; no SHIFT 


Strike the 11 Strike the !,] 
key with SHIFT. | key with SHIFT. 


Strike appropriate| [ Strike K with 
keys. SHIFT 
| Strike M with 
SHIFT 








Operators: 
| | (absolute) 


[ ] (brackets) 








( Strike the (,8 
key with SHIFT. 

) Strike the) ,9 

key with SHIFT. 


Strike the N > 
key with SHIFT 


Strike the ?,/ 
key; no SHIFT. 


Strike the * 
key with SHIFT. 


Strike the ry 
key with SHIFT. 


( ) (parentheses) 







~~” [een 





x© (exponent) 


x 
-D 
ry 


/ (divide) 


. (multiplication) 


+ (addition) 


Strike the =,- 


- (subtraction) 


key; no SHIFT. 


i 
ee” 





Boolean 
Expressions: 


Strike the =, - 
key with SHIFT. 


Strike the # ,3 # 
key with SHIFT. 


= (equal) 





A (not equal) 


tt 
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Table AID-3 (Cont) AID Character Set 


Standard Typing Method 
Math | JOSS 
Symbol AID Symbol Model 37! Models 33 and 35 Symbol Notes 






























< (equal to or less|< =(2 characters) Strike the<, .key < 
> than) with SHIFT; then 

strike the =,-key 

with SHIFT. 
> (equal to or > =(2 characters) Strike the >, . > 

















key with SHIFT; 
then strike the 
=, ~ key with 
SHIFT. 


greater than) 
































RUBOUT (types 
back as \ ) 


Strike DELETE 
key to erase 
each preceding 
character in 
error; then type 


Strike RUBOUT 
key to erase each 
preceding char- 
acter in error; 
then type 
correctly. 


BACK- 
SPACE and 
Type over 


Used to 
correct 
typing 
errors . 








Strike O key 
with SHIFT. 


null item 





_ (underscore) 


















Strike the $,4 
key with SHIFT 


Strike the $,4 
key with SHIFT. 


$ (current line 
number) 
* (cancel 

entire line) 





Strike the *,: 
key with SHIFT. 


| 
Blank boxes in this column represent characters whose keyboard positions have not yet been determined. 
This information will be supplied at a later date. 
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EXAMPLES 


1, Estimation of the square root (x;) of a positive number (A) by the iterative formula: 


A 
= a(x ae until A - (x. 


“i+ 


.R AIDA 
AID (1-30-68) AT YOUR SERVICE... g 
*1.1 Demand A.p 


*1.15 Type "GIVE ESTIMATION". 
*1.2 Demand X. 
*1.3 Set N= (3 )*XK+A/X).g 


*1.4 To part 2 if !A-(X #2) !>.00001., 


“1.5 Type A,X in form 1.g 


*1.6 Type X, X 42 in form 2. 
*2.1 SetX=N.qg 

*2.2To step 1.3.y° 

“Form I: 


\2 


< some "permitted deviation" value 


"A" is the positive value for which the square 
root is to be calculated, 


"X" is an estimated square root. 


This is the given formula (above) expressed in 
the AID language. 


Go to part 2 if the difference between the square 
root of the estimated square root and the actual 
number is greater than .O0000!. 


The difference is equal to or less than .Q0001; 
type the two values, A and X. 


Type the "proof" statement. 
Set the value of X for the next iteration. 
Return to recalculate. 


Set up forms for typing out results. 


*THE SQUARE ROOT OF 4ade- oe IS t0,.00¢<¢04- 


*Form 2: 


* PROOF: $< <<< SQUARED IS aq: ddt¢<-4 |) 


*Do part 1, 4 times.p 


A= *102 
GIVE ESTIMATION @/ 
X= “129 
THE SQUARE ROOT OF 102.00 IS 10.099505 wl 
PROOF:  10.099505 SQUARED IS 102.000001 a 
A = *133.39)) 
GIVE ESTIMATION @ 
x= *1iy 
THE SQUARE ROOT OF 133.3918 —11.549459y 


PROOF: = 11.549459 SQUARED IS 133.390001 J 
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GIVE ESTIMATION 


A = *1234.55 4 


X= 35 


THE SQUARE ROOT OF 1234.551S 35.136164g 
PROOF: 35.136164 SQUARED IS 1234.550000 


A= 454 


GIVE ESTIMATION g 


X= 42g © 


THE SQUARE ROOT OF 5.00 IS 2.236068 pg 


PROOF: 


* 


2.236068 SQUARED IS 5 .000000 W 


2 . Generation of Sine Wave 


*| 


| 


Do part 2 for l= 1 (6*3) 3 60*1.5. 


721 Set X=1. py 

*2e2 Do part 3. 9 

*2 53 Do part 4.9 

*3.01 Set X = X/57.2957795. of 
*3.02 SetA=I1.g 

*3.03 Set C=3.q 

*3.04 Set S=0.q 

*3.05 SetG=I1.g 

*3.06 Set Y=X.g 

*3.07 To step 3.50 if (X-2*3.14159) <O. py 
*3.08 Set X=X- 6.283191. 
*3.09 Tostep 3.06 

*3.10 Set Y=Y*X*X.p 

*3.20 Set A= A*C*(C-1).g 
*3.30 SetC=C+2.y 

*3.40 Set G=-G.g 

*3.50 Set T=S+G*Y/A.g 
*3.60 Tostep 3.90 if (T-S)=0. a 
*3.70 Set S=T.W 

*3.80 Tostep3.10.g 

*3.90 Done. 

*4 1 Type Min form IP ( (12 + 10*S) +1). 9 
*Form 1: 

*+ J 

*Form 2: pf 

* qd p 

*Form 3: 


* 


+3 
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) 
G 


Form 4g 
| a oe 
| + 3 
+3 
+3 
+3 
+3 
+3 
+3 
ap 
+ 
+3 
+ Y 


a 


*Form 6: 9 
* 

*Form 7: pg 
R 

*Form 8: 
*Form 9:9 
*Form 10:9 
* 

*Form il: 
*Form 12:4 
* 

*Form 13: 9 
% 

*Form 14: 
* 

*Form 15:3 
‘* 

*Form 16: 
% 

*Form 17: : 
* 

*Form 18: : 
%* 

*Form 19:9 ‘ 
* 

*Form 20: J 7 
* 

*Form 21 ip : 
* 

*Form 22: y 

%*% 


=o 
*Form 23: 
* 
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Generation of Sine Wave (cont) 


*Form 24: 9 
* 
*Form 25: pf 
* 
*Form 26:9 
*M= 8p 
*Do part 1. ¥ 
8 8 
7 8 
8 
8 
8 
3 8 
8 
8 
8 
3 8 
8 
8 
8 
8 
8 8 
? 8 
8 
a 
8 
8 
8 
8 
8 
—«B 
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+ 2 


+ 32 


Table AID-4 AID Diagnostic Messages 


tet a A value has not been supplied by the user for 
variable x. 


DONE. Signals completion of a File command (DISCARD, 
| oo FILE, RECALL). 


DONE. I'M READY TO GO( FROM ) STEP m.n.}...AT STEP m.n...Task was suspended by an 
IN interruption or error during 
the interpretation of an 
indirect step. 


..-FROM STEP m.n...Task was suspended by a 


stopping command. 


...IN STEP m.n...Task was suspended during an 
indirectly initiated DO 
command. 


AID resumes execution whenever the user types 


AT GO. 


DONE. I'M READY TO GO ¢ FROM Same as above, except that the step at which 
IN AID is prepared to resume can no longer be found 
STEP men, ALTHO I CAN'T FIND IT. in immediate storage . Possibly, a direct com~ 
mand (or a routine initiated by a parenthetical 
DO) has deleted the step in the interim. Upon 
| receipt of a GO command from the user, AID will 
attempt to resume at the step following the miss- 


DIRECTLY Ing STEP s 
DON'T GIVE THIS COMMAND | This command can be given only indirectly (TO, 
INDIRECTLY DONE, STOP, DEMAND) or only directly 
(CANCEL, GO). 


The previously entered line is incorrect. 


Indirect commands: The step number was 
incorrectly typed. 


Direct LET commands: LET x portion is 
incorrect. 


Other direct commands: A space was omitted. 
~The terminating 
period was omitted. 


The command is not 
legitimate. 


An expression is in- 
correctly written. 


To continue, retype the command correctly. 
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Table AID-4 (Cont) AID Diagnostic Messages 


Message | Meaning 


ERROR AT STEP m.n: EH? The step number is correct, but the command is 
incorrect. 


a. Request a typeout of the step in error. 
b. Check for the errors listed under "Eh ?". 
c. Retype the command correctly. 


d. Type GO. to continue. 


ERROR AT STEP m.n: The step in error refers to a nonexistent step or 
STEP pate 
I CAN'T FIND THE REQUIRED/ FORM .| Correct the error and type GO, to continue. 
PART 
FORMULA 
ERROR AT STEP m.n: (IN FORMULA x): The variable z has not been assigned a value by 
the user. 
z=??? | Check for any other errors, define variable z 
correctly, and type GO. to continue. 


ERROR IN FORMULA x: EH? (Following a direct command in which x was 


used) The form of the expression for x is in error. 
a. Request a typeout of formula x. 
b. Check for the errors listed under "Eh ?". 


c. Formula x may be correctly written, but the 
definition of one or more identifiers is not 
consistent with their use in formula x. 


FILE NUMBER MUST BE POSITIVE The filename of a USE command must not be 
INTEGER< = 2750 greater than the value 2750. 

FORM NUMBER MUST BE INTEGER AND Form numbers must be integers in the range | 
1< = FORM<10%9, through 107- 1. 


I CAN'T EXPRESS THE VALUE IN YOUR FORM. | A value cannot be expressed in the format speci- 
fied by the FORM (e.g., the value is too large to 
specify in fixed point notation). To correct, 

follow the steps given under "] HAVE TOO 

MANY VALUES FOR THE FORM." 










| FORM 
I CAN'T FIND THE REQUIRED { ITEM 
PART 









Either the element has never been defined or has 
been deleted. 
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Table AID-4 (Cont) AID Diagnostic Messages 


I CAN'T MAKE OUT YOUR FIELDS IN THE 
FORM . 












The fields in the form specified were typed in 
such a way that AID cannot distinguish their be- 
ginning or ending. Possibly, there are either no 
fields in the form or two or more are run together 
with no intervening space. 













IT HAVE AN ARGUMENT< = 0 FOR LOG. The argument for the LOG function must be 


greater than 0. 


















I HAVE A NEGATIVE ARGUMENT FOR SQRT. 


I HAVE A NEGATIVE BASE TO A FRACTIONAL 
POWER. 


Square root arguments must be positive. 


An attempt was made to raise a negative value to 
a fractional power. For example, 





Type (-y) # (1/2). 


Some number has exceeded 9.99999999 .10 4 99 


in magnitude. 





I HAVE AN OVERFLOW , 













| HAVE A ZERO DIVISOR. 
| HAVE NOTHING TO DO. 


An attempt was made to divide by 0. 





The user has typed GO., but there is no currently 
stopped process which can be continued. 











I HAVE TOO FEW VALUES. 


An insufficient number of arguments have been 
supplied for a function. 






There are not enough fields in the form to receive 
all the values to be typed. 


I HAVE TOO MANY VALUES FOR THE FORM. 






a. Type the form and the values. 





Check for errors. 










Change either the TYPE command or the 
FORM to make them compatible and then 
type GO. to continue. 











I HAVE ZERO TO A NEGATIVE POWER. 


An attempt was made to raise 0 to a negative 
power. 












ILLEGAL SET OF VALUES FOR ITERATION. An error has been detected in a range clause of 
a function or a DO command, such that the end- 
ing value can never be reached (e.g., the incre- 


ment is 0). 


When the user responds to a DEMAND-produced 
request (x=*) with a carriage return only, AID 
types back this message. 







I'M AT STEP man. 
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Table AID~4 (Cont) 


AID Diagnostic Messages 


INDEX VALUE MUST BE INTEGER AND 
!TINDEX! < 250 


I NEED INDIVIDUAL VALUES FOR A FORM. 


I RAN OUT OF SPACE. 


I RAN OUT OF FILE SPACE. 
ITEM NUMBER MUST BE = 25. 


NUMBER-OF-TIMES MUST BE INTEGER AND 
>=0. 


PART NUMBER MUST BE INTEGER AND 
1< =PART 1099. 


PLEASE DELETE THE ITEM OR USE A NEW 
ITEM NUMBER. 


PLEASE KEEP !X!< 100 FOR SIN(X) AND 
COS(X). 


PLEASE LIMIT ID'S TO 5 LETTERS AND/OR 
DIGITS... 


All index values (subscripts) must be integral and 
must have an absolute value of < 250. 


A command was given to type a subscripted vari- 
able ina form (e.g., Type B in form 1, where 
B is a subscripted variable). Individual values 


only can be specified for TYPE ....IN FORMn 


commands. 


User's immediate memory is filled due to one of 
the following errors. 


Endless loops because of DO commands or 
because DO was typed instead of TO. 


Unlimited recursive definition. 


Variable x defined in terms of y, and vari- 
able y defined in terms of x via LET com- 
and. | 


Program is too large for available memory; 
use TYPE SIZE command to determine how 
much immediate storage has been used. 
File commands can be used to store parts of 
the routine and execute them one at a time. 


DECtape directory is full (limit = 22 items) . 


The item number in file commands (DISCARD, 
FILE, RECALL) must be less than or equal to 25 
(22 for DECtapes) . 


The value specified in the TIMES clause of a DO 


command must be a positive integer. 


Part numbers must be integers and in the range 


1 through 10° -1. 


The user has attempted to FILE information into an 
item which already exists on the currently open 
external storage file. The user must either 


DISCARD the item prior to filing the new infor- 


mation or use a different item number in the FILE 
command. 


Arguments for the SINE and COSINE function 
must be less than 100. | 


Filename in a USE file command or code ina 
DISCARD, FILE, or RECALL command exceeds 
five characters in length or contains special 
characters. 
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Table AID-4 (Cont) 


PLEASE LIMIT LINES TO 78 UNITS (CHECK 
MARGIN STOPS) SAY AGAIN: 


PLEASE LIMIT NUMBERS TO 9 SIGNIFICANT 
DIGITS. 


PLEASE LIMIT NUMBER OF INDICES TO 10. 


PLEASE LIMIT NUMBER OF PARAMETERS TO 
TEN 


PLEASE LIMIT STEP LABELS TO 9 SIGNFICANT 
DIGITS. 


REVOKED. I RAN OUT OF SPACE. 
ROGER. 


SOMETHING'S WRONG... I CAN'T ACCESS 


THE FILES. 
SOMETHING'S WRONG. TRY AGAIN. 


SORRY. SAY AGAIN: 


STEP NUMBER MUST SATISFY 
I< =STEP <10 ? 9. 


STOPPED BY STEP m.n. 


YOU HAVEN'T TOLD ME WHAT FILE TO USE. 


AID Diagnostic Messages 


User typeins are limited to single-line, 
78-character strings. | 


Numeric values are limited to nine significant 
digits. 
The number of subscripts following on identifier 


cannot exceed 10. 


The number of arguments for a function is limited 


to 10. 


Step numbers can be up to nine digits in length. 


See "IT RAN OUT OF SPACE." 


Signals successful completion of a USE file 
command. 


A system I/O error (or other type of AID error) 
has occurred. Begin again. 


AID has found something unusual in its internal 
records or has received contradictory signals from 
its I/O routine. Begin again. 


A transmission error occurred on the previous 
typein. This message is preceded by the erroneous 
line with # symbols typed where the failure 
occurred. Retype the line. 


Step numbers must be in the range | through 1071 : 


Process has been temporarily halted by a STOP 
command at step m.n. 


The user has issued a DISCARD, FILE, RECALL, 
or TYPE ITEM=LIST command before he has given 


a USE file command. 
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| | DESK CALCULATOR (DESK) 


To give the user direct access to arithmetic functions 


FUNCTION 


for problem solving. 


e@ A powerful conversational problem-solving 
system 


@ No complex programming rules to follow; prob- 
lems are entered by use of familiar arithmetic 
operators and functions 


@ Permits the user to define new macro operations 
for those functions not contained in the basic 
repertoire 


ENVIRONMENT 










Minimum Core 4K (no macros) or 5K! 


Additional Core None | 
[Equipment Required Console Teletype; other devices are optional. 









ee DESK-1 


INITIALIZATION 


RK DESK) Loads the Desk Calculator program 
| into core. 
P | The Desk Calculator is ready to receive 


the first problem statement. 


COMMANDS 


Table DESK-1. Desk Pseudo-—Commands 


pa GSS Ss OPPOSES SSS PSS SS APS eh VSP SS SSS SG 


e 
& 
: 2 % 
‘ @ 


Clear the accumslato 


$K functionname Delete the function specified by the user. 
If no function is specified, delete all 
user functions and set all variables to 1.0. 





$Ga Get the value assigned to the symbol! 


a." If none is assigned, the value 0 is 
assumed. 


$L Output line (carriage return followed by 
line feed). Used in macro operations. 


Place a value into "a," 


Round output to n significant digits. 


$ Round output to nearest integer (same as 
| SFO). . 


$R | Secondary exit from a macro operation, 


Output tab. Used in macro operations. 
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Desk Functions 


Table DESK-2 


Description 


Function 


% 
oe 


pas 
en 
G 
Ee 
6 
Ss 
os 
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Table DESK-3 Desk Command String Symbols 


Symbol 


esta a i “” i “ : “ — 





Directs Desk to output the expression value 
followed by a tab. 





evaluate the expression and 





ALTMODE key 


Arithmetic Operators Add 
Subtract 
Multiply 
Divide 
Raise to 
the power 
Parentheses 


n the same line. 








A maximum of nine arguments can be specified 
within a macro function in the form 

macro=mnemonic (A,, Ans ue A) 

é it 


Arguments are written in the form *n (1Sn89) 





in the variable 
on the right 


Comments Comments are enclosed within quotation 


marks ("), 





Labels within macro functions can consist 
of two or three digits followed by a colon (:). 





Macro mnemonics can consist of two or three 
alphabetic characters. 


Macro Mnemonics 
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Desk Command String Symbols 


Table DESK=3 (cont) 


Function 


Symbol 


Transfers Within Macro Statements 





Variables 


DESK=5 


EXAMPLES 


.R DESK, 

Ps Pie. 
p oy 
$F5) ~ Ly 
SIN(10) #— @LIMODD 0.54402) 


$F3) 


COS (10), 


¥ 0.839 


$DCMP; 2 
#1=X 2p 


#2=Y 9 


$FIXIYIX+YIX492+Y92a— 52) 


CMP (4,6) Q 


4.0 6.0 10.0 52.0) 


"X SINX COSX" 


Round ali results to the first five significant decimal 
positions. 


Compute the sine (in radians) of 10 and type the re- 
sult on the same line. | 


Round all results to the first three significant deci- 
mal positions. 


Compute the cosine (in radians) of 10 and type the 
result on the next line. 


Define a macro operation called CMP. 


The first argument entered whenever CMP Is used Is 
represented in the formula by X. 


The second arqument entered whenever CMP is used 
o 


is represented in the formula by Y. 


Each time CMP is used, print the following values 
rounded fo the first significant decimal position: 
x 
Y 
A+Y¥ 


2 va 
xX + 
To use macro routine, type the macro mnemonic 


followed by the arguments within parentheses. 


Values are typed out. 


Xx YY At x47 


Define a macro operation called TYP. 
Step 1. Print a columnar heading. 
2. Performa line feed. 


3. Argument 1 is represented in the formula 


os X. 


4, Argument 2 is represented in the formula 


as Y, 
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1:$F 1X !$F5SND(X) !CSD(X)!$L 


X+#3=X 


TGE(Y-X, 1)\<+— : Q 


TYP (10,60, 10)) 


X 

10.0 
20.0 
30.0 
40.0 
50,0 
60.0 


8c) 
-KJOB,) 


SINX 

0.17365 
0.34202 
0.50000 
0.64279 
0.76604 
0.86603 


5. fag 
ra 
O~ 


“y /. 
ie use the rot 


followed | by rne 


COSXQ 

0.98481) 
0.93969) 
0.86603) 
0.76604) 
0.64279) 
0.50000) 


eros 4. a pie 45 £8 ae oe 2 f f _ ie o> get wg de aes Bsa, 
Print out the value of X (aecurate to 
al. Pe a ev ge ee wen haul ee eee 
rhe tirst SIQHMICONT Gec imal posil 2} 
ee % 4 gen J H ‘ bom 

rollowecd Oy G TOD: 
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2 eee ee etre pe hee HL 
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§ ; ‘ < 
MODE Beh, BH? Me, me gh i on} q » Se SE oN ore bb 
Zero, GO DaCK TO lag otherwise 


exit ae the routine. 


Kill the wn release core, 
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Table DESK~4 


Command 


a 
x 
O 
Y 
= 
fe) 
Cc 

= 
hee 


SAVE) 

Qa 

ixty! x $24+v 92 qa— 
SAVE ») 


° 
f 


=X a 
=YQ 
$FIX!Y 

$Wa 


M 
[am | 
= 
< 
= 
= 
© 
a 
— 
— 
a. 
_ 
—_ 
© 
~~ 
_— 
— 
a... 
= 
=< 
Fa) 
Usd 
a 


.R DESK) 


$Sinput-dev: filename .ext 
$ODSK 


$Ooutput-dev 
Example 

$DC MP 

#1=X 

#2 

CMP (4,6) ,) 
$KCMP) 
$SDSK 
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CMP 5,8). 


$Y¥Q 

CMP (3,9)) 

320: 9.0: 12,0" 90,0) 
ac) 

.KJOB,) 
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DIAGNOSTIC MESSAGES 


Table DESK-5 Desk Diagnostic Messages 


Message Meaning 


2DEVICE NOT AVAILABLE Either device does not exist or it has been assigned 


to another job. . 
?DIRECTORY CAPACITY EXCEEDED DECtape or disk directory is full. 
EVALUATOR UNABLE TO DECIPHER THIS An illegal formula (macro definition, etc.) or an 


illegal character has been entered. 


2 FILE NOT FOUND 


The filename.ext specified as the input source can- 
not be found on the device. 


FUNCTION EXPECTS ARGUMENT LIST 


Required arguments are missing for the last function 
specified. 


ILLEGAL FUNCTION DEFINITION 
IMPROPER DUMMY SYMBOL 
IMPROPERLY FORMED ARGUMENT LIST 


An illegal format has been entered. 
A symbol has not been assigned or used properly. 


Desk expected a list of arguments but found con- 
stants mixed in. 


IMPROPER NAME IN LEFT HALF 


Desk expected an argument name in the left half 
of a word but found something else. 


IMPROPER PARENTHESES COUNT 


The number of left parentheses does not match the 
number of right parentheses. 


P?INTERNAL ERROR 


An error has been made by Desk. Restart from be- 
ginning. 


entry IS AN ILLEGAL CHARACTER A character cannot be interpreted as a variable, 


operator, or pseudo-op. 


entry IS AN ILLEGAL FIELD SIZE 


Size of field exceeds expected number of decimal 
positions. 


entry IS AN ILLEGAL FUNCTION NAME Entry has not previously been defined as a function. 


entry IS AN ILLEGAL PSEUDO-OP A $x entry, where x is other than C, D, Fn, G, I, 
K, L, O, P, R, S, T, W, or Y, ts unrecognizable. 


?PUSHDOWN OVERFLOW 








The pushdown list in Desk has overflowed. 
UNDEFINED LABEL IN A TRANSFER A label appearing in a transfer statement (STP or 


Txx) is not defined elsewhere in the routine. 


VARIABLE NAME IN RIGHT HALF INCORRECT 


Desk expects a variable in the right half of an ex- 
pression but instead finds a constant. 
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FUNCTION 


ENVIRONMENT 















Monitor 


Minimum Core 


Additional Core | Sufficient core to run the Batch-controlled jobs. 


Equipment Required 


BATCH PROCESSOR (BATCH) 


To supervise the sequential execution of a series of 
jobs with a minimum of operator attention. 


® Operates as one of the "users" of the system in 
a time-sharing evnironment 


® Maintains constant communication with the 
operator and allows him at any time to interrupt, 
skip, repeat, or prematurely terminate one or 
more of the jobs in the series 


¢ Runs concurrently with the Batch-controlled 
object jobs 






One Batch input device, one Batch output device, one 
scratch device, and the shared SYS device. If on 
disk, all of these may be the same device. 






BATCH-1 


| INITIALIZATION | 


-ASSIGN dev BPTEMP J The logical name BPTEMP (scratch device) must be 
assigned to a retrievable device (DSK, DTAn, MTAn) 
before beginning Batch. 


wR BATCH } Loads the Batch Processor into core. 


. Indicates that Batch is reacy to receive a command, 


NOTES: 1. Batch is always ready to receive a 
command, whether or not an asterisk 
has previously been typed. However, 
when an asterisk does appear, Batch is 
specifically requesting a command and 
will not proceed without one. 


2. &C must never be typed except im~- 
mediately following an asterisk type- 
Out. 
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COMMANDS 


wn 
a 
Cc 
c¢3] 
& 
Cc 
2 
” 
”Y 
f 
Oo 
O 
> 
o 
a) 
_~ 
2D 
Qo. 
area 
6 
—— 
YU 
ofjne 
oe) 
co 
mr 
j_ 
> 
QO. 
Cc 
— 
— 
O 
ae 
(@) 
mo 





INPUT dev:.ext 





: and DTAn: only) 


(DSK 


.ext 





ao 
x 
0) 


OUTPUT dev 


: and DTAn: only) 


(DSK 


.ext 








Ld. Gowen piste 


Myris 
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Job Control Commands 


SKIP nd 


Execute the nth job on the Batch input device. 


The first job control command to Batch is normally 
SKIP 0 


(i,¢., no jobs are skipped and execution begins with 
the first job). 


Once Batch processing has begun, the SKIP commnad 
has the following effects. 


SKIP 0 Restart the current job. 


SKIP n After the current job is finished, ex- 
ecute the nth job after the current job. 


SKIP =n After the current job is finished, ex= 
ecute the nth job prior to the current 


one (i.e., repeat the previous n job 
executions). 


NOTE: — The following commands can be issued at any point after Batch job execution has been started 
by the first SKIP command. Once Batch has been started, automatic sequential execution of 
the jobs on the Batch input device is performed unless the operator intervenes. 


BREAK J 


* 


CONTINUE} 


DUMP) 


EFOUT) 


END} 


Finish the current job and halt before continuing on 
to the next job. The operator must then enter a com~ 
mand before Batch continues processing. 


Resume processing at point where Batch was interrupted. 
lf Batch was doing nothing when interrupted, Batch 

responds with an asterisk; the operator must then type 
a SKIP command to continue. CONTINUE its used to 
resume processing after the user has responded to one 
of the Batch operational messages (see Table BATCH-1). 


Output a core dump of the current job on the Batch 
output device. This command can be issued at any 
time. Batch automatically continues at the next job. 


Write an end-offile on the Batch output device. 
Batch responds by typing “SPECIFY NEW OUTPUT 
DEVICE" followed by an asterisk. The operator must | 
then type an “OUTPUT dev:.ext” command followed 
by a CONTINUE command. 


Terminate the current job immediately. 
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EXAMPLES 


ASSIGN DSK BPTEMP} 
DSK ASSIGNED) 


wR BATCH } 
*INPUT PTR: } 


*OUTPUT LPT: 
*SKIP OJ 
$JOB TESTOI,12 200 16,11 NANCY 


MOUNT TAPE D2621 WRITE ENABLED) 


DTA6: 2 


OK 
*CONTINUE) 


BREAK 


RUN TIME - 23 SECS.) 
*SKIP 2) 


$JOB PASS1 BEAVER, 12 200 16,11 NANCY 


DUMP J 
RUN TIME - 12 SECS.) 


$JOB PASS2 BEAVER, 12 200 16,11 NANCY Q 


RUN TIME - 32 SECS.) 
END OF BATCH g 


*OC rl 
.KJOB gd 
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Assign the Batch scratch file, BPTEMP, 
to the disk. 


“a 


i 


o 


fcrtch. 


PAP Z 
fone Woe Sat & 


Assign the paper tape reader as the 


Was 


’ BS pbeek Se 
Prambg 2¥ gevice. 


+ 


enema. bi + ae . s 
Assign the line printer as the output 


Lianthioatien & eee Se SE SOME 
initialize Batch execution; begin with 
the first job fou n the input device 
CO martante «tf $i ct © te l wpe 
Contents of the first 3 JOB card are 
typed out. 

AAs : 
Message to operator to mount a DEC- 

ae Sees ee | mi ae ae a ~ oe PVE, 
fape, serial number 2621, on a DEC- 


Operator mounts the tape on an avail- 
aa i 


either before or after 


ee | ¥ 
typing the physical name and number 
of the drive, 


Batch responds with message "OK, ' 


Operator types eo NTINUE®" to re- 


Slee ée the current job, but halt be- 
fore continuing to the next job. 


% a : x ik 
Run time typed out. 


Skip the next two jobs and continue at 
the third job. 


Typeout of $JOB card. 


Perform a core dump on the current job 
and terminate the job; resume processing 
at the next job. 


Typeout of $JOB card. 


All jobs on the Batch input device have 
Bee processed, 


Return to the Monitor. 


Kill the job, deassign the BPTEMP de- 


vice, release core, 


Table BATCH-1 Batch Diagnostic Messages 


XXX XXX ? 
dev ? 


END OF BATCH 







The previous operator typein, xxx xxx has no mean- 
ing to Batch. 


An illegal device was specified in an INPUT or 
OUTPUT command. 








The end of file has been reached on an input stack 
(nondirectory devices). : 


If the Batch input stack is on a directory-oriented 
device, the message can mean that either (1) end 
of the input stack has been reached, or (2) no such 
file exists on the device. : 


FILE BEING MODIFIED | A selected disk file is currently being accessed by 
| another user. 


MAX. TIME EXCEEDED The time limit specified on the $JOB card has been 
exceeded. The operator can respond with a typein 
of "TIME" to extend the time limit indefinitely. 


ENABLED 
MOUNT TAPE label WRITE Operator looks for available tape unit (if label be- 
LOCKED gins with a "D," a DECtape unit is being requested; 
if label begins with an "M," a magnetic tape unit 
is being requested) and types in the physical name 
and number of the device in the form 


DTAn: or MTAn: \ 


If the device is available, Batch responds with "OK." 
The operator then mounts the requested tape (identi- 
fied by the serial number "label") on the drive, sets 
the WRITE switch in the proper position, and types 
"CONTINUE" to resume processing. 


NO. PTY'S AVAILABLE No pseudo-Teletypes are available. The user must 


wait until one of the current Batch jobs is finished. 


NOTE: The user can increase the number of pseudo- 
Teletypes available by recreating his 
Monitor via Build. There are no hardware > 
limitations (except core - each additional 
pseudo-Teletype requires about 20g words 
of core and each possible time-shared "job" 
requires about 50g words). 
















NO SUCH JOB The operator typed a SKIP command with an argument 
which resulted in a reference to a nonexistant job 


number on a directory device. 


| NO SUCH UFD Reference has been made to a nonexistant UFD 
(User File Directory). a 
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Table BATCH-1I (cont) Batch Diagnostic Messages 


dev NOT AVAILABLE The device either does not exist or has been assigned 


to another job. The "MOUNT " message is 
repeated. 





OK Typed following a correct operator response. Type 
"CONTINUE" to resume processing. 


* 


PLEASE ASSIGN dev TO BATCH PROCESSOR | Operator must: 

. Return to Monitor level (9C); 
. Assign the requested device (ASSIGN dev); 
. Type "CONTINUE"! to Monitor; and 
. Type "CONTINUE" to Batch. 








PLEASE ASSIGN DEVICE BPTEMP 


* 





The operator has failed to assign a device to the 
Batch scratch file, BPTEMP. He must: 


1, Return to Monitor level ($C), 
2. Assign the device (ASSIGN dev BPTEMP):; 
3. Type "CONTINUE"! to Monitor; and 

. Type "CONTINUE" to Batch. 





















PLEASE MOUNT A SCRATCH TAPE Operator responds by typing in the name of the 


drive on which the tape has been mounted (e.g., 
DTA3, DTAZ etc.). 


PROTECTION FAILURE | The disk file referenced was protected. 


RUN TIME =- n_ SECS. The total running time for each user job is typed at 
the end of the job. 


SPECIFY NEW OUTPUT DEVICE This message appears following the operator's use of 
: the EFOUT command. The operator must type 


OUTPUT dev: } 
before typing CONTINUE. 











dev : TRANSMISSION ERROR An I/O data or device error has occurred. 


TRIED RENAME TO EXISTING NAME This is the result of attempting to rename an existing 
file to a name that already exists on the disk (applies 
to disk files only). 


USER NEEDS DEVICE dev When device is available, operator types "'CON- 
‘ TINUE" to resume processing. 


NOTE: 1. Typing "REENTER" (instead of "CONTINUE") to Monitor causes Batch to respond with an 
asterisk, following which the operator types "CONTINUE" to Batch. (If "CONTINUE" is 


typed to Monitor, Batch responds only with a carriage return.) 
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JOB STACKER (STACK) 


This section was not available at publication time, but will soon be available as an insert. 


If you do not receive this insert, please write to: 


DEC Program Library 

Digital Equipment Corporation 
146 Main Street 

Maynard, Massachusetts 01754 


STAC K-1 








specialized for the user's particular 


machine configuration. 


SYSTEM BUILDER (BUILD) 
(FOR TIME°SHARING MONITORS) 


FUNCTION To construct a time-sharing monitor 


@ Permits the distribution of Monitor as a set of 
modular subprograms, the selection of which 


is determined by the user's requirements 


® Employs an easy-to-use dialogue technique 
for requesting information from the operator 


ENVIRONMENT 





Monitor 









10/40, 10/50, or Minimal Monitor 


3K plus core needed for monitor being built. 
Additional Core Uses as much core as given in R(UN) command. 


Equipment 
Required 











One DECtape unit for the input Build tape, containing the 
following files: 


SYS50 = - for 10/50 systems 
SYS40D_ - for 10/40 systems with a disk 
SYS40N - for 10/40 systems without a disk 


ole eee of your PDP-10 is included in the software kit accompanying your machine. 
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COMMANDS 


a. 


. AS DTA3 DTAI d 
DTA3 ASSIGNED g 


.R BUILD coreg 


DTAI is the logical device name 
assigned to the Monitor library file. 


Core available can be specified as 
any number of 1 K modules. 


The user has the option of using an existing command list file as input to Build instead of 
conducting the dialogue described below (the first question asked is whether the user has such a file on 
a device). If the user has no such file (this would, of course, be the case when a given configuration 
is to be built for the first time), he may have one created as a by-product on some retrievable device 
as he conducts his Teletype dialogue; whether or not such a file is created is determined by the user's 
response to the second question asked. Thus, for all subsequent building operations where the same 
configuration is desired, the user can utilize the command list file created during the first building process. 


The file created is automatically given the extension LST, and any command list file read by 
Build is expected to have the same extension (thereby ensuring compatibility); the user may not type an 
extension. If the user types the filename only, the device is presumed to be DTAI, the Build input device. 


TYPE "DEVICE: NAME<CR>" OF FILE WHERE ANSWERS 
_ ARE PRESTORED® 
TYPE <CR> ONLY FOR TELETYPE DIALOGUE g 


TYPE "DEVICE: NAME<CR>" TO CREATE A COMMAND 


FILE; <CR> FOR NONE Y 
DSK: SYSABCg 


IS EITHER A 10, 20, OR 30 SYSTEM TO BE BUILT 


(TYPE Y OR N)?y 


No 


IS A 10/40 SYSTEM TO BE BUILT (Y OR N)? 9 


Yep or Nd 
DO YOU HAVE A DISK? g 
Ye or Ng 


DO YOU HAVE AN RD1I0 SWAPPING DISK? y 


Ye or Ng 
DO YOU HAVE A PDP-10 PROCESSOR g 
Yd or Ng 


If a file is specified, only question j 
will be asked out of those listed below. 


If Y, the single-user Build code is 
written over the current time-sharing 
Build code and begins executing. 


A 10/40 or 10/50 system is to be built. 
Type Y if 10/40; type N if 10/50. 


Type Y if you have a disk; type N if 
you do not. 


If response is N, a PDP=6 processor is 
assumed. 


DO YOU WISH TO HAVE EXEC DDT LOADED (Y OR N)?qg Type Y if you wish DDT loaded Fak 


Yox or Nag 


DO YOU WISH TO HAVE LOCAL SYMBOLS LOADED 


(Y OR N)?q 
Yd or Ny 


Monitor testing; type N if you do not. 


Needed only if EXEC DDT is loaded. 
Type Y if yes; type N if no. 

NOTE: EXEC DDT and local symbols 
need be loaded only for Monitor de- 
bugging. | 


TYPE NAME OF THIS SYSTEM (10 CHARACTERS OR 
LESS) of 


VERSIONI0g 


TYPE NAME OF SYSTEM DEVICEg 
DSKy 


WHICH OF THE FOLLOWING LINE SCANNERS DU 
YOU HAVE? ¥ 


DCS (DATA COMMUNICATION SYSTEM 630) py 

DLS (DATA LINE SCANNER DC10) a 

CCI (COMPUTER-COMPUTER INTERFACE DA1I0O WITH 
PDP-8 AND 680 SYSTEM) y 

TYPE DEVICE MNEMONIC yg 


DLS y (or either of the other two) 


DO YOU HAVE ANY OF THE FOLLOWING?q 
TYPE Y ORNg 


PT READER? JJ 
Yep or Nag 

PT PUNCH? g 
Yop or Ny 
PLOTTER? J 

Yop or Ny 
LINE PRINTER? 
YX or Ny 
CARD READER? y 
Ys or Ng 

IS YOURS A MODEL CR-10 PDP-10 CARD READER? J 
Yox or Nag 
DISPLAY? 9 

Yop or Ng 


HOW MANY (DECIMAL) OF EACH OF THE FOLLOWING 
DO YOU HAVEg | 


DEC TAPES? J 

no 

MAG TAPES? 

7 

DO YOU HAVE A TM-10 MAG TAPE CONTROL 
(Y OR N)?9 


Ys orNg 
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Type in the name you wish assigned to 
this monitor version. This name is 
printed on the Teletype whenever this 
version is loaded. 


Type the name of the device to which 
the logical name SYS is to be assigned. 


Type Y if you have the device or fea- 
ture; type N if you do not. 


Type a decimal number signifying the 
number of each type of device. 


n = 0 through 8 (Type 0, not N, if none). 


n = 0 through 8 (Type 0, not N, if none). 


JOBS TO RUN AT ONE TIME (BOTH ATTACHED 
AND DETACHED)? 


ng 

PSEUDO TELETYPES?y 

ng 

TYPE "DEVICE-MNEMONIC: CHANNEL" FOR 


ANY NONSTANDARD DEVICES 
TYPE ALT-MODE WHEN THROUGH 


* MET :6 


- @MOBE) 


TYPE "SYMBOL = VALUE" FOR ANY CHANGES 
(VALUE IN DECIMAL) 
TYPE ALT-MODE WHEN THROUGH g 


JIFSEC = nn 
N SPMEM = nnnn 


DTTRY = ng 


MTSIZ = nnng 


LPTSIZ = nn y 


DETDDB = ng 


STDENS = ng 


Global = Pl-number 
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Enter the device mnemonics and 
priority channels for any of the user's 
own device service routines. 


Enter symbol and value for any global 

symbol to be changed, in the form 
symbol = value 

Power source frequency. Standard = 60. 


Memory cycle us X 1000. 
Standard = 2000. 


Number of retries on DECtape errors. 
Standard = 4, 


Size of magnetic tape records (i.e.,_ 
number of words in buffer). 


Standard = 128. 


Size of printer buffer (in number of 


words). Standard = 24. 


Maximum number of detached jobs. 
Standard = 0. 


NOTE: (Number of jobs run at one 


time)-(number of Teletypes) = n 
Magnetic tape density and parity 
SIDENS= De? 


Dd c 
1 (200 bpi) O (odd) 
2 (556 bpi) 4 (even) 
3 (800 bpi) as 


Standard = 2 (HP bpi, odd) 


User can also change standard priority 
interrupt assignments. 


PTRCHN = 3 


ALTMODE)J 


Device 


Paper tape rdr 
Paper tape pnch 
Line printer 
Card reader 
Display 
Scanner 

C. Teletype 
Arith. Proc. 
Light pen 

Clock 

D/Ctl - DEC/mag 
D/Ctl = Disk 
DECtape 
Magnetic tape 
Disk 


TYPE"DEVICE:NAME"FOR ANY SPECIAL ROUTINES 


TO BE LOADED. 


TYPE ALT-MODE WHEN THROUGH J 


DTAI:XYZSER y 


ALTMODE),J 


TYPE "DEVICE:NAME <CR>" FOR STORAGE MAP: 


<CR> FOR NONE 
LPT: or 
LPT NOT AVAILABLE 


Global Standard 


10/40N 10/40D, 

— ___10/50__ 
PRTRCHN 4 5 
PTPCHN 5 6 
LPTCHN 4 > 
CDRCHN 3 4 
DISCHN } 6 
SCHCHN 4 5 
CTYCHN 4 5 
APRCHN S 4 
PENCHN 5 6 
CLKCHN 7 7 
DCTCHN 2 3 
DCBCHN - 1 
DTCCHN 5 5 
MTCCHN A 5 
DSKCHN - 6 


lf on 10/40N system, changes Pl 
assignment of paper tape reader from 


4 16:3% 


Enter device and routine name for any 
routine to be included in the Monitor 
but not linked with the rest of Monitor 
(i.e., not linked to either the priority 
interrupt chain or with the other data 
(blocks); also for any device specified 
in response to the query "TYPE..... 
FOR ANY NONSTANDARD DEVICES" 
whose binary code is not in the appro- 
priate Build file. All files must be in 
Macro~output, Loader-input (relocatable 
binary) format. 


Delay occurs after ALTMODE until 
loading of routines is completed, 


TYPE "DEVICE :NAME<CR>" FOR STORAGE MAP: <CR> FOR NONE ® 


DSK: SYSABC J 
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File SYSABC ..MAP will be written on 
the disk from which if can be copied 
at some later point in time. 


EXIT 
CH 


SAVE DTAI filename .ext J 
JOB SAVEDY 
“Cy 
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BUILD overlays itself with the construct- 
ed Monitor and exits. 


User must now save the constructed 
Monitor ona DECtape. 


DIAGNOSTIC MESSAGES 


Table BUILD-1 Build Diagnostic Messages 


CANNOT ENTER FILE The file-structured device for the command list file or the storage 
map is unable to receive an entry into its directory. Try: 


a. DECtape - Directory full 
b. DSK: - User file directory is write protected, or 
the file is being modified. 


ERROR IN LOADER COMMAND A system or hardware malfunction has occurred. 








Build input tape is in error. Try to rerun. If second attempt fails, 
recreate the Build input tape and run again. 






ILL. FORMAT LIBRARY TAPE BAD 


INPUT ERROR LIBRARY TAPE BAD. 












A read error has occurred on the Build input tape. Try to rerun. 
If second attempt fails, recreate the Build input tape and run 
again. 















name.LST NOT FOUND ON DE- 
VICE dev (Preceding message is 
retyped) 


User specified a command list filename that did not exist on the 
particular device. | 





_ symbol old-val new-val A global symbol has been multiply defined. The old value is 
MUL.DEF GLOBAL accepted, the new value is ignored, and processing continues. 


dev NOT AVAILABLE Device is not available. Request another device. 


NOT ENOUGH CORE Occurs only when Build is being run in a time-sharing environ- 
ment. Assign more core and rerun Build. If this method fails, 
try one or more of the following. 















a. Run Build under a monitor containing only DECtape 
and line printer service routines. 


b. Do not load either EXEC DDT or local symbols. 







PROGRAM MUST BE RESTARTED 
WITH "RUN" COMMAND 








User typed "START", but part of the START code has been over- 
written by Build. User must use GET or RUN command to bring 
new copy of Build into core. 














filename.REL NOT FOUND 


One of the user's programs requested for inclusion in the 
Monitor cannot be found on the device specified. Correct 
and re-enter the request. 





or 


SYS....REL NOT FOUND 





b. User has wrong library input file for configuration desired; 
check answers to questions c, d, and e of dialogue. 















symbol NOT FOUND 
TYPE "DEVICE: NAME<CR>" 
FOR STORAGE MAP; <CR> 
FOR NONE 


A device data block or device interrupt service routine cannot be 
found. Try the following: 
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Table BUILD-1 Build Diagnostic Messages (Cont) 


LPs 
[Prints map on line printer. | 
EXIT . 




















a. If the user is including his own routines in the Monitor, 
he should check that the tags on his device data blocks 
and interrupt service routines are spelled correctly and 
are globals. 


b. Check if a device service routine is missing from the 
input library file. 


c. Check storage map for symbols. 





d. Restart Build from the beginning. 








UNDEFINED GLOBALS 


This message may appear at the end of the requested storage map 
printout on either the line printer or the Teletype. If all input 
to Build is supplied by Digital, this message should not occur. 


WHAT ? User has made a keyin error. Correct and re-enter. 
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SYSTEM BUILDER (BUILD) 
(FOR SINGLE-USER MONITORS) 





FUNCTION To construct a single-user Monitor specialized for 


the user's particular machine configuration. 


e Permits the same modular distribution of 
Monitor components and user specialization 
and utilizes the same easy-to-use dialogue 
technique as the time-sharing version. 


ENVIRONMENT 












10/20, 10/30, or Minimal Monitor 


Additional Not used 
Core | 


Equipment 
Required 


One DECtape unit for the input Build tape, containing the 
following files: 














SY SPAR 
SYSDEV 


NOTE: An up-to-date set of instructions for constructing your single-user system and "getting on the 


air" upon delivery of your PDP-10 is included in the software kit accompanying your machine. 
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COMMANDS. 


INIT 


. -AS DTA3 DTAIg | DTAI is the logical device name 
; assigned to the Monitor library file. 


- DTA3 ASSIGNEDg 


-RUN DTAI BUILD J 


DO YOU HAVE FLOATING POINT AND BYTE 
HARDWARE? 


Yox or Ny If answer is N(o), simulators for these 
functions will be loaded as part of the 
Monitor. 


DO YOU HAVE ANY OF THE FOLLOWING? 
TYPE Y OR Ng 
PT READER? g 

Yop or Ng 

PT PUNCHY 

Yo or Ny 
LINE PRINTER ? gl 
Ys or Ng 
CARD READER? W 
Yd or Ng 
DISK? 9 

Yop or Ng 


HOW MANY OF EACH OF THE FOLLOWING DO 
YOU HAVE 


DECTAPES? g 
na Where n is in the range 0 through 8. 
MAGTAPES? 9 
no Where n is in the range 0 through 8. 


TYPE "DEVICE-MNEMONIC:CHANNEL" FOR 
ANY NONSTANDARD DEVICES y 


TYPE ALT-MODE WHEN THROUGH Enter the device mnemonics and priority 
channels for any of the user's own device 
service routines. 


*MET:3 (ALTMODE)q 
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TYPE "SYMBOL = VALUE" FOR ANY CORRECTIONS 
DESIRED A 


TYPE ALT-MODE WHEN THROUGH yg The value of any global symbol can be 
changed by typing 


*PTRCHN = 3 (ALTMODE Ri symbol = value 


Among the globals whose values can 
be changed (and their standard values 
in decimal) are: 


DTTRY = 3 (Number of retries 
on DECtape errors) 


MTSIZ = 128 (Size of magnetic 
tape records, i.e., 
number of data words 
in the buffer) 

LPTSIZ = 24 (Size of line printer 
records, i.e., number 


of data words in the 
buffer ) 


STDENS = 2 (Magnetic tape density 
cand parity ~ see page 
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Priority channel interrupt assignments 


Device Global Standard Assignment 

Paper tape reader PTRCHN 4 
Paper tape punch PTPCHN 5 
Line printer LPTCHN 5 
Card reader CDRCHN 4 
Teletype TTYCHN vi 
Arithmetic Processor APRCHN © 

DECtape DTACHN 5 
Magnetic tape MTACHN 2 


Disk DSKCHN | 
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TYPE "DEVICE: NAME" FOR ANY SPECIAL 
ROUTINES TO BE LOADED. ¢ | 


TYPE ALT-MODE WHEN THROUGH g 


“DTAZXYZSERCALTMODE) 2 


WHAT IS THE SIZE (IN K) OF CORE? g 
nn 


DO YOU WANT A STORAGE MAP? 9 
Yop or Ng 
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Enter device and routine name for any 
routine to be included in the Monitor 
but not linked with the rest of the 
Monitor (i.e., not linked to either the 
priority interrupt chain or with the 
other data blocks); also for any device 
specified in response to the query 
TANGER Esveuk-cg-< FOR ANY NONSTANDARD 
DEVICE" whose binary code is not in 
the appropriate Build file. All files 
must be in Macro-output, Loader-input 
(relocatable binary) format. 


Type the size of core in decimal; the 
value must be a multiple of 8. 


If a storage map is requested, an INIT 
is performed by Build on the line 
printer. Ifa line printer is not avail- 
able, the storage map is printed on the 
user's Teletype. 


Build overlays the old system with the 
newly generated Monitor, initializes 
it, and exits to the new Monitor. The 
new Monitor responds with a dot. At 
this point the user can begin typing 
commands to the new Monitor, or first 
save the new Monitor on DECtape by 
typing | 


.AS DTAO SYS# 
REENTERg 


This causes the new Monitor to be 
saved on the SYS device (DTAO, in 


this example). 


DIAGNOSTIC MESSAGES 


The diagnostic messages for the single-user Monitor Build are the same as those for the time- 


sharing Monitor Build (see Table BUILD-1). 
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TIME-SHARING MONITORS 
FUNCTION To schedule multiple-user time sharing of the system, 


to allocate available facilities to user programs, to 
accept input from and direct output to all system I/O 
devices, and to relocate and protect user programs 

in core. 


@ Provide an advanced, third-generation, multi- 
programming, and time-sharing environment 


@ Allow for a wide range of system facilities, from 
a minimum configuratign-of 16K of core and two 
DECtapes up througt-262K/of core and a variety 
of devices, such koe tapes, disks, dis- 
plays, plotters, real-time digitizers, and analog 


_ converters 
wok 
MONITOR 10/40 A proven multiprogramming time-sharing system which includes an I/O | 


controller, run-time selection of I/O devices, job-to-job transition, 
job save and restore features, and memory dump facilities. All of these 
features are incorporated with concurrent real-time processing, batch 
processing, and time sharing. 


MONITOR 10/50 A full-range, disk-swapping, multiprogramming time-sharing system 
incorporating all of the features of Monitor 10/40 with greatly ex- 
tended capacity. 


Both of these systems are custom tailored to the user's needs by use of the System Builder. 
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CONSOLE MODES 


Monitor Mode The console is in communication with the Monitor. All characters 
typed in are presented to and interpreted by the Monitor Command 
Interpreter. 

User Mode | | The console acts as an ordinary I/O device under control of the user's 
program. 

DDT Submode A special user Teletype I/O mode which does not interfere with the 


normal user I/O mode. 
Detached Mode The console is not in communication with either the Monitor Command 


Interpreter, DDT, or a user's job. Entered when the Monitor is first 
initialized or when DETACH is typed. 


CONT, HELP, REENTER, 





<e START ASSIGN, ATTACH, CCONT, CORE, CSTART, D, 
IN DAYTIME, DEASSIGN, E, FINISH, GET, KJOB, 
\ s P JOB, REASSIGN, RESOURCES, SAVE, TALK, 
on \. yj” \EIME ERRONEOUS COMMANDS 


DETACH 


a sey oui 


— e_ eee a= = ee _— eee fe fee one 


Ee esis 
ATTACH 





ILL. COMMANDS 





Figure MONITOR-1 Console Teletype Mode 
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Table MONITOR=1 Time=Sharing Monitor Commands (Cont) 



























Format Action magica Diagnostic Messages 
teristics 
ASSIGN SYS:dev To change the systems device to m 


device "dev." The user must be L 
logged in under either{1, 1] or 


Rie 





DEASSIGN dev 





m NO SUCH DEVICE 


Returns one or more devices, cur- 
rently assigned to the user's job 

to the Monitor's pool of available 
devices. 


Device name does not exist, 
DEVICE WASN'T ASSIGNED 


dev If this argument is 
not specified, all 
devices assigned to 
the user's job are 
deassigned. | 


The device isn't currently as- 
signed to this job. 


If this argument is 
specified, it can be 
either the logical 
or physical device 
name, 












REASSIGN dev job DEVICE dev WASN'T ASSIGNED 


Allows one job to pass a device 
to a second job without going 
through the Monitor device pool. 











The device isn't currently as~ 

signed to this job. 

dev The physical name of 
: JOB NEVER WAS INITIATED 

the device to be re- 

assigned. Cannot be a 


user console, 
















The job number specified has 
not been initialized. 


NO SUCH DEVICE 





The number of the job 
to which the device 
is to be reassigned. 





The device does not exist. 


DEVICE CAN'T BE REASSIGNED 





A user's console Teletype can- 
not be reassigned. 


FINISH dev 

















Terminates any input or output NO SUCH DEVICE 


currently in progress on the device. 






Either the device does not exist 
dev The logical or physi- or if was not assigned to this job. 
cal name of the device 
on which 1/O is to be 


terminated. 










If no name is speci~ 
fied, 1/O is terminated 
on all devices assigned 
to the job. - 


TALK dev BUSY 









To allow the user to type directly 
on another user's console. 















The console addressed is either (1) 
not in the detached mode or the 

Monitor mode, or (2) is not posi- 
tioned at the left margin. 


dev Must be one of the 
following 















CTY - Console 
Teletype 


TTYn - Where n can 
be in the 
range of 0 


through 77. 
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Table MONITOR-1  Time=-Sharing Monitor Commands (Cont) 


. h = 
Format Action C oe 
teristics 


TALK (cont.) OPR - Operator's 
console (the 
Teletype de- 
: signated as 
| such when the 
Monitor was 
initialized). 
m 


| COREn To modify the amount of core as- 
/ signed to the user's job. J,A,1 
n= Total number of 1K 
blocks of core to be 
| assigned to the job 
: from this point on, 
If n is omitted, Mon- 
itor types out a value 
representing the num- 
: ber of 1K blocks of 
oo unallocated core in 
its pool. 


“RESOURCES To print out all the available de- 
vices (except TTY's) and the 
aan number of free blocks on the disk. 
_ | DETACH dev To assign the device "dev" to 
2 JOB 0, thus making it unavailable. 
a i i. must be logged in under 
: ieee 


m 
L 
: / / ATTACH dev To return a detached device to the m 
. Monitor pool of available devices. L 
: The user must be logged in under 
— | Lt). | 
TOCALL, | RUN dev Te odd aicerevimage-tromuades u | dev: NOT AVAILABLE 
LOAD, AND] _ filename. ext trievable storage device and start L ee eee ges 
CONTROL | [proj, prog] it at the location specified within St a ie ee rere 


Diagnostic Messages 















PROGRAMS | ~ core the file (JOBSA). another job. 


dev The logical or physical NO SUCH DEVICE 


name of the device 
containing the core 
image. Omitted if if is 
the systems (SYS:) de- 


Vice, 


The device does not exist. 
nk OF CORE NEEDED 


There js insufficient free core to 
load the file. 


filename.ext The name of the file NOT A DUMP FILE 
containing the core 
image; if .ext is 
omitted, if is assumed 


to be .DMP. 


The file is not a core image file. 


[proj,prog] Project-programmer TRANSMISSION ERROR 
number; required only 
if core image file is 

located in a disk area 


other than the user's. 


A parity or device error occurred 
during loading. 
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Table MONITOR-1 Time-Sharing Monitor Commands (Cont) 


Charac- 


Format Action ae 
teristics 


Diagnostic Messages 


RUN (cont.) Amount of core to be 


assigned if different 
from minimum core 
needed to load the 
program or from the 
core argument of the 
SAVE command which 
saved the file. Re- 


quired only if dev: is 
MTAn: 


GET dev Same as RUN command except that 

filename. ext SY Monitor types out 

[proj, prog JOB SETUP 

core “Wh and does not start execution; also, 

if the core argument is not in- 
cluded it is assigned a value equal 
to the user's current core allocation 
(the SAVE core argument, if it had 
been used, is ignored). 


START adr Begins execution of a program pre- 
viously loaded with the GET com- 
mand. 
adr The address at which 

HALT @C) Places the console in Monitor mode m 
and transmits a HALT command to 
the Monitor Command Interpreter. 

Stops the job and stores the program 
. counter in the job data area 
(JOBPC). 
fu 


CAN'T CONTINUE 





4 CONT : Starts the program at the saved 
program counter address stored in 
JOBPC by a HALT command @C) 
or a HALT instruction. 


DDT Copies the saved program counter 
value from JOBPC into JOBOPC Ba ee) | 
and starts the program at an al- 
ternate entry point specified in 
JOBDDT (beginning address of DDT 
as set by Linking Loader). To re- 
turn to normal execution, type fC | 
and START (or type prog-start- 
adr$G). : 


7 
| 
| REENTER Similar to the DDT command. U 
— Copies saved program counter LsJ,C;1 | 
- value from JOBPC into JOBOPC 
S and starts program at an alternate 
entry point specified in JOBREN 
(must be set by the user or his pro- 
gram). To return to the interrupt- 
- ed computation, type REENTER | ( 
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Table MONITOR-1  Time-Sharing Monitor Commands (Cont 


Format Action nae Diagnostic Messages 
teristics 


To examine a core location in the OUT OF BOUNDS 
user's area. 


adr 


mE ete 
oS Gi ed 


D Th rh adr Deposit information in the user's OUT OF BOUNDS 


eer es The specified adr is not in 


Th user's core area. 


lue fo be 
din the right 
he location. 


dress of the lo- 

into which the 
information is to be 
deposited. 


lf adr is omitted 


the location following 
the last location ex- 
amined or deposited. 


SAVE dev To write out a core image of the n 1K BLOCKS OF CORE NEEDED 


filename. ext user's core area on the specified Petre natant Race Beas 
device. If DDT was loaded with is less than the contents of JOBFF. 
the program, the entire core area 

is written; if not, the area starting © DEVICE NOT AVAILABLE 

from zero up through the program 
break (as specified by JOBFF) is 


written. After output is com- 


pleted, the message TRANSMISSION ERROR ' 
JOB SAVED | _ An error was detected while yeonth! mM 


% 


Device dev is assigned to another 
user. 








is typed. 


writing the core image file. 
dev The device on which 
the core image file DIRECTORY FULL 
is to be written. The directory of device dev is 
| full; ne more files can be added. 


filename.ext [he name to be assignec 
tothe core image file. If 
.ext is omitted if is ossumec 


to be . DMP. 
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Action 





Amount of core in 
which the program is to 
be run. This value is 
stored in the job's core 
area (JOBCOR) and is 
used by the RUN and 
GET commands. Speci- 
fied as number of 1K 


blocks, 


If core is omitted, only 
the number of blocks 
required by the core 
image area {as ex- 
plained above) is as~ 
sumed. 


Monitor responds by typing the job 
number to which the user's console 
is attached. If the console is not 
attached to a job, Monitor assigns 
a job number and types the job 
number and a line identifying the 
Monitor version. 
















ae PJOB 

CONTROL 

BAC K- 

GROUND | 
JOBS 


| | CSTART 
_| CCONT 





Identical to the START and CONT 
commands, respectively, except 
that the console is left in the 
Monitor mode. 


To Use: 


Same as START and CONT. 






1. Begin the program with the 
console in user mode. 





Type control information to 
the program, then type?C 
to halt job with console in 
_ Monitor mode. 


Type CCONT to allow job to 
continue running and leave 
console in Monitor mode. 







Further Monitor commands can 
now be entered from the 
console. 



















Disconnects the console from the 
user's job without affecting the 
status of the job. The user console 
is now free to control another job, 
either by initiating a new job or 
attaching to a currently running 
background job. 
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_| ATTACH job 
| Leroi, pros] 


To connect a console to a back- 
ground job. 


If an error message occurs, the 
console remains attached to its. 


iob The job number of the current job. 


job to which the con- 
sole is to be attached. 
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Table MONITOR-1 Time-Sharing Monitor Commands (Cont) 


Charac- 


Format Action Diagnostic Messages 


teristics 





ATTACH (cont.) [ proj, prog] The project- TTYn ALREADY ATTACHED 
programmer number of 
the originator of the 
desired job. 


Job number typed is erroneous 
and is attached to another con- 
sole, or another user is attached 


Automatically detaches the console to the job. 


from any job to which it is currently JOB NEVER WAS INITIATED 
attached. 


The job number is not assigned to 
any currently running job. 


If job is running, typing CONT 


places the console in the user mode 
without affecting the operation of NOT, JOB ORIGINATOR 


the job. 


The project-programmer number 
entered is not that of the origin- 
ator of the desired job. 


Stops all allocated I/O devices and 
returns them to the Monitor pool. 
Returns all allocated core to the 
Monitor pool. 


Returns the job number to the 
pool, 


Leaves the console in the Monitor 
mode, 


Performs an automatic TIME com- 
mand. 


DAYTIME Types the date followed by the time 
of day. Time is typed in the format. 


hhmm:ss.ss 


where 
hh = hours 
mm = minutes 
ss.ss = seconds to the nearest 


hundredth. 


| TIME job Types out the total running time used 
by the job since it was initialized. 


Interrupt level _and-job scheduling 


awe 
wast! 


times are~éharged to the user who 
was‘running when the interrupt or re=- 
cCheduling occurred. | 


nee 
pean? 
amine 


eran nts" 
Ain ah Neb HEAR ARAS PEROT ME 


job The job number of the 
job whose timing is 
desired. 
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Table MONITOR-1 = Monitor Commands (Cont) 


Charac- 


Format Action er 
teristics 


Diagnostic Messages 















If job is omitted, the 
iob to which the con~ 
sole is attached is as~ 
sumed. In this case, 
Monitor types out the 
incremental running 
time (running time 
since last TIME com- 
mand) as well as the 
total running time since 
the job was initialized. 


TIME (cont.) 




















imation of the time 
spent core shuffling is 
printed, followed by 

the running time of the 
null job, and the total 
system up time. 













Characteristics: 







\ 
; 


d =places console in detached mode =LOGIN required (10/50 Monitor; J =requires a job number 


m=places console in Manitor mode =n 







»§ console in user mode 
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Table MONITOR=-2 Time=Sharing Monitor Device Summary 


Physical . drogen 1) 0), 
Device ‘C fe 5 Data Modes | 


TTYn Teletype INPUT, OUTPUT A, AL | 
(n=0 
thru 7) » P WV 


DECtape 


Magnetic tape 
























INPUT, OUTPUT 
LOOKUP, ENTER, 
USETO, USETI, 
UGETF, 

CALL [SIXBIT/ 
UTPCLR/ | 


INPUT, OUTPUT 
MTAPE 





A, AL, IB, B, I, DR, D 













A, AL, IB, B, I, DR, D 


- 








INPUT, OUTPUT 
LOOKUP, ENTER 


A, AL, IB, B, I, DR, D 

















/y | i | 
EaraMioges: /A\ ese / DR/= Dump records 
/ Al = ASCII line tS) Dune 
1B = Image binary ko | 





B= Binary 


— Bes ses 
NES ATS . 


MONIT OR-1 1 





In addition to the diagnostic messages given for each command, Monitor also types out the following 
error diagnostics. Except for the DEVICE dev OK? and HALT AT USER adr messages, all messages are 
for errors so serious that Monitor stops the job and does not allow the user to continue execution of the 


job with a CONT command. 


Table MONITOR-3 Time=Sharing Monitor Diagnostic Messages 


ADDRESS CHECK FOR DEVICE dev AT USER 


adr 





Monitor has checked a user address and has found 
it to be too large (> C(JOBREL)) or too small 
(<< JOBPFI). Some user addresses can be the 
user's accumulators while others cannot. 














One of the following addresses may be wrong: 
. buffer 

buffer header 

dump mode command list 

data specified by dump mode command list 
insufficient core available for setting up 
Monitor-generated buffers. 






BAD DIRECTORY FOR DEVICE DTAn; 
UUO AT USER adr 








The DECtape directory is not in proper format or 
had a parity error when read. Many times this 
error occurs when an attempt is made to use a 
virgin tape. 


DEVICE dev OK? 








Device dev is temporarily in an inoperable state, 
such as LPT offline. The user should correct the 
obvious condition and then type a CONT com- 

mand. 
ERROR IN JOB n A fatal error has occurred in the user's job (or in 
Monitor while servicing the job). This typeout 
is normally followed by a I-line description of 

the error. 






The user program has executed a halt instruction 
at loc. adr. Typing CONT will resume execu- 
tion at the effective address of the halt. 
HUNG DEVICE dev; UUO AT USER adr A device has not generated an interrupt for a 
timed period and, therefore, is in need of 
attention. 


ILLEGAL DATA MODE FOR DEVICE 
dev AT USER adr 


The data mode specified for a device in the 
user's program is illegal. 
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Table MONITOR-3  Time-Sharing Monitor Diagnostic ida (Cont) 


T ILLEGAL UUO ATUSERadr i ti(‘ititsS™S UUO AT USER adr An Sees On canteens =| UUO has been executed at user 
location adr. 


ILL INST. AT USER adr An illegal operation code has been encountered 





in the user's program. 


ILL MEM REF AT USER adr An illegal memory reference has been made by 
| the user program at adr or adrt1. 


INCORRECT RETRIEVAL The retrieval pointers for a file are not in the 
INFORMATION: UUO AT USER adr correct format; the file is unreadable. If this 


typeout occurs, the user should report it on a 
Software Trouble Report. 


INPUT DEVICE dev CANNOT DO An illegal OUTPUT UUO has been executed 
OUTPUT; UUO AT USER adr at user location adr. 

cain cali CHANNEL AT No OPEN or INIT was performed on the channel. 
USER adr 


JOB CAPACITY EXCEEDED 


























The job capacity of the system (i.e., the ca- 
pacity selected when this Monitor was generated 
by Build) has been exceeded. The command is 
ignored. The user must wait until another user 
has relinquished his job number. 









or 











LOGIN PLEASE 
? 





A Monitor command requiring that the user be 
logged in has been typed, but the user is not 
logged in. Perform LOGIN and repeat the 
command. 








LOOKUP AND ENTER HAVE 
DIFFERENT NAMES: UUO 
AT USER adr | 








An attempt has been made to read and write a 
file on the disk. However, the LOOKUP and 
ENTER UUO's have specified different names on 
the same user channel. This message does not 

indicate a DECtape error. 


MASS STORAGE DEVICE FULL; The storage disk is full. Users must delete un- 
UUO AT USER adr needed files before the system can proceed. 


NON-RECOVERABLE DISC READ 
ERROR; UUO AT USER adr 


NON-=RECOVERABLE DISC WRITE 
ERROR; UUO AT USER adr 




















Monitor has encountered an error while reading 
or writing a critical block in the disk file struc- 
ture (e.g., the MFD or the SAT table). If this 
condition persists, the disk must be reloaded us- 
ing Failsafe after the standard location for the 
MFD and SAT table has been changed using the 


Monitor once-only dialogue. 
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Table MONITOR-3 Time=Sharing Monitor Diagnostic Messages (Cont) 


NOT ENOUGH FREE CORE IN The Monitor has run out of free core for assign- 
MONITOR: UUO AT USER adr ing disk data blocks and Monitor buffers. If 


this typeout occurs, the user should report it on 
a Software Trouble Report. 


NOT FOUND The program file requested cannot be found on 
| the systems device (or on the specified device). 


OUTPUT DEVICE dev CANNOT DO An illegal INPUT UUO has been executed at 
INPUT; UUO AT USER adr user location adr. 

PC EXCEEDS MEMORY BOUND AT An illegal transfer has been made by the user 
USER adr program to user location adr. 


SWAP READ ERROR A consistent checksum error has been encountered 
when checksumming locations JOBDAC through 
JOBDAC+74 of the Job Data area during swap- 


ping. 


SWAPPING DEVICE FULL The swapping device is full of user core images. 
One or more users must eliminate their core 
images by typing KJOB before the user can pro- 
ceed. This message is printed every 30 seconds 
until space is made available. 


TOO FEW ARGUMENTS A required argument was omitted in a Monitor 
command string. 
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| SINGLE-USER MONITORS 
FUNCTION 


To perform job-to-job transitions, assign I/O devices 
at run time, and perform all I/O device service func- 
tions for standard devices. 


e Provide Monitor control of jobs and ease of 
programming for I/O devices in a single-user 
environment 


e Provide upward compatibility with the time- 


sharing Monitors 10/40, 10/50 


e Allow for a wide range of system facilities, from 
a minimum configuration of 8K of core (16K for 
the 10/30 Monitor) and paper tape up through 
262K of core and the same range of devices 
given for the time=sharing Monitors 


MONITOR 10/10 A single-user Monitor for an 8K paper tape system. Includes an I/O 
Controller, run-time selection of I/O devices, job-to-job transition, 
job save and restore features, and memory dumps. 


MONITOR 10/20 A single-user Monitor for an 8K DECtape system. Includes the same 
versatile features as the 10/10. 


MONITOR 10/30 A single-user Monitor for 16K and larger systems. Includes the same 
versatile features as the 10/10. 


All of these systems are custom-tailored to the user's needs by use of the System Builder. 
Y | Y y 
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CONSOLE MODES 


Monitor Mode The console is in communication with the Monitor. All characters 
typed in are presented to and interpreted by the Monitor Command 
Interpreter. 

User Mode The console acts as an ordinary 1/O device under control of the user's 
program. 

DDT Submode A special user mode which does not interfere with the normal user 
mode. 


ASSIGN, DATE, DEASSIGN, 
GET, INIT, KJOB, SAVE 











CONT, REENTER, RUN, START 





MONITOR 
MODE 


DDT 
\ SUBMODE 


Figure MONITOR-2 Console Teletype Modes (Single-User) 











&C, EXIT, ERROR MESSAGES 
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COMMANDS 


Table MONITOR-4  Single-User Monitor Commands 


Charac- 


Format Action Possible Causes of "?" Diagnostic 


teristics 










































TO Initializes the I/O package for the m 
INITIALIZE user as follows. 
ae ot 1. Releases the logical names (ex- 
cept SYS) assigned to every 
device. 
Release the directory space of 
every device having a logical 
name. 
Sets the contents of JOBREL 
equal to the address of the first 
location below the Monitor. 
TO ASSIGN phys-dev To assign an I/O device to the user's m a) phys-dev could not be found. 
ALLOCATE log-dev job for the duration of the job or by acces yea peauucastraacd 
until a DEASSIGN command is given g a a 






FACILITIES 


snes 


for the device. 









phys-dev = Any device listed in 
Toble MONITOR-5., 
This argument is re~ 
quired, 








log-dev A logical name assigned 
by the-user (e.g., in 
writing his program, the 
user may use arbitrari/y 
selected device names 
which he can then as~ 
sign fo the most con- 
venient physical devices 

at run time). This argu- 

ment is optional 


de 



















DEASSIGN dev 





dev could not be found. 


Releases the logical name from the 
device and core space allocated to 


its directory (if any); updates JOBREL 







dev This argument can be 
either the logical or 
physical device name. 
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Table MONITOR=4 = Single-User Monitor Commands (Cont) 


° 


Possible Causes of "?" Diagnostic 
a) dev could not be found. 

b) progname could not be found. 
c) (JOBSA), = 0, 

a) dev could not be found 

b) progname could not be found 


Charac- 
teristics 


aaa 
; 


is omi 


ing Loader. 
JOBREN 


mn 


taining the core image. 
ink 


If this argument 
ted, the Systems (SYS) 


The logical or physical 
name of the device con- 
device is assumed. 

The name of the file 
containing the core 


is not started 
To return to the inter- 


job 
ied by the user 


the program counter value is in 


JOBOPC. 


fF 


itor mode and transmits a HALT com- 
speci 


mand to the Monitor Command In- 
stored in the saved program counter 
Restarts an interrupted job at a point 


(JOBOPC) following a HALT com- 


mand (#C). 
the location specified in JOBDDT. 


Starts execution of the program at 
This location is set at the starting 
rupt point, execute a JRST 2, @ 


the program counter in the job data 
JOBOPC. 


Gives control to a job at its starting 
area JOBOPC. 


address, as specified by the right 


half of JOBSA. 
terpreter. Stops the job and stores 


Same as the RUN command, except 
Starts the program at the address 


® 
AS co 
i 
— 
5 oO 
So eee 
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, 
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os 
cs 
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t 
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address of DDT by L 


progname 
that the 


RUN dev progname 
GET dev progname 


See 
ees 


TO CALL, 
LOAD, AND 
CONTROL 
PROGRAMS 
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Table MONITOR=4 Single-User Monitor Commands (Cont) 


Charac- 


fepier x Possible Causes of "?" Diagnostic 
istic 


Format 


SAVE dev progname Copies the contents of the user's core a) dev could not be found. 
area (and part of the job data area) 
onto device "dev" and assigns it the 
filename "progname.SAV". If DDT 
is loaded, the area of core from c) Transmission error 
JOBDDT through the address con- 
tained in JOBREL is saved: other- 
wise, the core area from JOBDDT 
through the job break (address in 
JOBFF) is saved. : 


b) progname cannot be ENTERed 
on the device 


Kills the job and releases every 
TERMINA-~ active device. 
TION 


SYSTEM DATE mm-=-dd-yy Converts the date typed by the user 
TIMING to the standard internal format and 
stores it in the system date location. 


Characteristics: m Command places user's console in Monitor mode. 
u Command places user's console in user mode. 
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DIAGNOSTIC MESSAGES 


Table MONITOR-5 Single-User Monitor Diagnostic Messages 


Generally, this typeout means that a command 
was typed incorrectly (e.g., a space was omitted, 
a parameter was omitted or misspelled). Other 
reasons for this message are given under the head- 
ing "Possible Causes of the ? Diagnostic," Table 
MONITOR-4. 
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[ assematy INSTRUCTIONS FOR CUSP SOURCES 


The only source programs requiring special assembly or loading procedures are: 


F4, F40, F4S, F40S 

PIP and PIP] 

DDT and Exec Mode DDT 
GLOB 

AID 

DESK 


Detailed instructions for assembling and loading the above programs follow. All other CUSP 
(Commonly Used System Programs) sources are assembled using Macro, and then simply loaded and saved. 


F40 


The PDP-10/PDP-6 FORTRAN IV Compiler consists of a single set of source files which, 


through conditional assemblies, produce the following: 


1. F40/F4: Full-scale FORTRAN IV, which will compile programs on any PDP-10/PDP-6 
having a minimum of 9K of user core available. The code it produces will run on the 
computer which compiled it. | 


2. F40S/F4S: An abbreviated version of F40/F4 which will operate in 5.5K of user core 
on the PDP-10/PDP-6. 


The Compiler source consists of five files: EXEC, FXO, FX1, FX2, FX3. 
F40 is the PDP-10 Compiler. 
F4 is the PDP-6 Compiler. 
F40.SAV is the name given to the F40 Compiler on the PDP-10 CUSP. 
F4.DMP is the name given to the F4 Compiler on the PDP-6 CUSP. 
To create F40.SAV or F4. DMP: 
1. Assemble FX1, FX2, FX3 as one file (F40.REL or F4.REL). 
2. Assemble EXEC as EXEC.REL. 
3. Load EXEC, then F40.REL or F4.REL in 11K. 
4. Save F40 or F4 in 9K. 
To create F40.SAV or F4S. DMP: 
1. Assemble FXO, FX1, FX2, FX3 as one file (F40S.REL or F4S.REL) 
2. Load F40S.REL or F4S.REL in 8K. 
3. Save F40S or F4S (in 6K for 10/40, 10/50 systems). 


CUSP-1 


The executive (FXO or EXEC) handles all input/output operations. Before assembling the files 
FX1, FX2, and FX3, the user may define some parameters to conserve space or give the Compiler addi- 
tional features (see below). All the parameters except DEBUG have been defined in the small executive 
(FXO), enabling the abbreviated version to reside in approximately 5.5K of core instead of 9K. 


HALFWD 
$CCONS 
$FAD 


SIMPL 
$DATA 
$CODE 
$ NAME 
— $CREF 
DEBUG 


Assemble interpretive instructions two per word. 
The Compiler feature of collapsing constants will be removed. 


The Compiler will not use floating point instructions in its cal- 
culations. If $FAD is defined, $CCONS will be automatically 
defined. 


The IMPLICIT statement will not be accepted. 

The DATA statement will not be accepted. 

The binary listing option will be removed. 

The NAMELIST statement will not be accepted. 

The cross-reference symbol table feature will be removed. 


The debug package will be assembled. 


| ASSEMBLE/LOAD PROCEDURE 


1. F40: 
.R MACRO Q 


*DSK:EXEC, <- DTAn:EXEC 


*DSK:F40, + DTAn:FX1.MAC, FX2.MAC, FX3.MACQ 


*9c2 
.R LOADER} 


*DSK:EXEC, F40 o 


LOADER} 

EXIT 2 

“cd 

. SAVE DSK F40 9) 


2. FAOS: 
.R MACROQ 


*DSK:F40S, a DTAn:FXO, FX1, FX2, FX3) 


*4C3 
-R LOADER 2 


*DSK:F40S (ALTMODE) a 


LOADER Q 
EXIT 
4c, 


.SAVE DSK F40S 6) 
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| PIP, PIP1, QPIP 


PIP: Assemble separately the files COMSN and PIP. 
There are two assembly parameters in PIP: WCH and BLOCO. 


WCH = 0 New (i.e., PDP-10) format DECtapes are assumed. 
WCH = 1 Old (i.e., PDP-6) format DECtapes are assumed. 


BLOCO not defined Block 0, 1, and 2 copying is allowed. 


BLOCO defined No block 0, 1, and 2 copying is allowed. 
Typical procedures for PIP assembly, load, and save are: 
.R MACRO } 
*DTAn:PIP, & TTY:,DTAm:PIP } 
WCH= 0). 
9Z 3 
END OF PASS ONE 3 
WCH = 0) 
#Z 3 
*DTAn:COMSN, DTAm:COMSN J 
+4 [Ci 
Then load the two files as follows. 
.R LOADER 2 
*DTAn:COMSN , PIP! (ALTMODE) J 
LOADER 2 
EXIT Q 
fc 


SAVE DTAn:PIP 3 2 


PIP]: Assemble separately he Files COMSCN.MAC and PIPI1.MAC. Then load them as follows, 
noting the order. 


.R LOADER 
*DTAn:COMSCN,, PIP] (ALTMODE) , 
LOADER} 
EXIT? 
4c) 


Now save PIP] on your CUSP 
SAVE DTAn:PIP1 1) 


QPIP is an ASCII file containing the switch information which PIP prints upon encountering the 
/Q switch in a command string. The QPIP file should simply be transferred to your CUSP using PIP. 
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DDT 


a. User DDT is kept as a REL file and as a SAVED file on the CUSP tape. 


Assemble the file DDT ,MAC with Macro. DDT assembles with one argument 'A' error. This error 
may be ignored and does not affect the user at all. DDT.REL is transferred onto qa CUSP via PIP, 
while the GET and SAVE Monitor commands are used for DDT.SAV. 


How to Load and Save DDT.SAV 


-R LOADER 42 Load in 4K of core! 

*DTAI:DPT,/140G @LTMODE)& 

LOADER 

EXIT 2 

er 

- START Enter DDT. 

$$H JOBSYM/ (777616)7616 ) Type out, in halfword mode (JOBSYM). 

6! (7616)3616) J Open register 6; put (JOBSYM)pp into (6), 14; put 
(JOBSYM)p14-4000g into (6)RH. 

BLT 6, 3777$X Perform block transfer through 3777¢. 

JOBSYM! (777616)3616 ) Open JOBSYM; leave left half as is; change right 
half to 4000g less than it was. 

$$Zn Zero memory (except DDT). 

JossA/ (0)DDT (ppTEND)DDT) Open JOBSA. If left half # DDTEND, change it. 

$$8 Change back to symbol type-out mode. 

4C | Return to Monitor level. 

“CORE 22 Reduce core to 2K, 

START Reenter DDT. 

JOBRE \/ 3777} Check JOBREL. 

SCE Return to Monitor level. 

‘SAVE DTAI DDT Q Save DDT on CUSP. 


Explanation - The DDT saved file must be saved in 2K (minimum amount of core needed for it). Also, 
a starting address must be set up for DDT as location 140. To get DDT into 2K, the DDT symbol 

table must be moved down to the upper end of the first 2K of core. Any unused locations in DDT 
should be set to zero ($$Z) and JOBSYM should be set to the new location of the start of the DDT 
symbol table. Before saving the resulting file, a CORE 2 request should be given to the Monitor 

to ensure that DDT is saved as a 2K core image. 


‘i this example, the Loader ran in 4K of core. Even if the Loader is run in more than 4K of core, the 
same general principles apply. 
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b. EXEC DDT 


The Exec mode version of DDT assembles from the file DDT.MAC by using a parameter file from the 
Teletype as shown below. 


R MACROg 

*DTAn:EDDT ,LPT: @ TTY:,DTAm:DDT 
EDDT = 1) 

9Z) | 

END OF PASS ONE} 

EDDT = 1) 

72) 


There are other versions of DDT that may be assembled. Please refer to the first page of the source 
file for explicit instructions. 


| GLOB 


The three source files of the global cross-reference program (CROSSX, CROSS, and SCAN) 


are assembled separately by Macro and loaded as one file. The specific loading instructions are: 


-R LOADER 

*DTAn: a CROSS, SCAN @LTMODE) 8 
LOADER J 

EXIT) 

Sc. 


‘SAVE DTAm: GLOB 2 2 
AID 


There are three source files for AID: INTERP, ARITH, and KMON. Assemble these files 
separately and load as follows. 


R LOADER} 

EON ANDI ANTEN 
EXIT? 

"Ca 


SAVE DTAI AID 11) 
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| DESK | 
| 


The three source files of the Desk Calculator are: FOP, NUMBER, and DECS. Assemble 
these separately and load them as one file. The specific loading instructions are: 


.R LOADER) 

*DTAn:FOP, NUMBER, DECS (ALTMODE) J 

LOADER } 

EXIT 2 

aco 

SAVE DTAn: DESK ng | n= 4 if macro capability is not desired; 
A if it is desired. 
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DIGITAL EQUIPMENT CORPORATION e MAYNARD, MASSACHUSETTS 


Printed in U.S.A. 
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